flonat-research 0.1.0

package/.scripts/task

@@ -0,0 +1,213 @@
+#!/usr/bin/env python3
+"""
+Quick task entry for Notion Tasks Tracker.
+
+Creates tasks with "Inbox" status by default (GTD-style capture).
+Requires "Inbox" status option to exist in Notion Tasks tracker.
+
+Usage:
+    task "Task description"
+    task "Task description" --project "Journal Revision" --priority high
+    task "Task description" -p "[Project]" -d tomorrow
+    task "Read paper" --area Research
+"""
+
+import argparse
+import json
+import os
+import sys
+import urllib.request
+import urllib.error
+from datetime import datetime, timedelta
+
+
+# Configuration
+NOTION_TOKEN = os.environ.get("NOTION_TOKEN")
+DATABASE_ID = "YOUR-TASKS-DATABASE-ID-HERE"
+
+PROJECTS = [
+    "Journal Revision",
+    "[Project] Theory",
+    "Objective-Architecture",
+    "[Project]",
+    "AI Mental Health",
+    "API Transparency",
+    "[Project] Research",
+    "Teaching",
+    "Personal Admin",
+]
+
+PRIORITIES = ["High", "Medium", "Low"]
+
+AREAS = ["Research", "Teaching", "Career", "Personal", "Health", "Learning"]
+
+SOURCES = [
+    "Meeting",
+    "Email",
+    "Supervisor request",
+    "Self-initiated",
+    "Deadline/calendar",
+    "Idea capture",
+]
+
+
+def parse_date(date_str: str) -> str:
+    """Parse natural language dates."""
+    today = datetime.now()
+    date_lower = date_str.lower()
+
+    if date_lower == "today":
+        return today.strftime("%Y-%m-%d")
+    elif date_lower == "tomorrow":
+        return (today + timedelta(days=1)).strftime("%Y-%m-%d")
+    elif date_lower in ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"]:
+        days = ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"]
+        target = days.index(date_lower)
+        current = today.weekday()
+        diff = target - current
+        if diff <= 0:
+            diff += 7
+        return (today + timedelta(days=diff)).strftime("%Y-%m-%d")
+    else:
+        # Try to parse as YYYY-MM-DD or DD/MM/YYYY
+        for fmt in ["%Y-%m-%d", "%d/%m/%Y", "%d-%m-%Y"]:
+            try:
+                return datetime.strptime(date_str, fmt).strftime("%Y-%m-%d")
+            except ValueError:
+                continue
+        return date_str
+
+
+def create_task(
+    name: str,
+    project: str = None,
+    priority: str = "Medium",
+    due_date: str = None,
+    source: str = "Self-initiated",
+    area: str = None,
+    description: str = None,
+):
+    """Create a task in Notion."""
+
+    if not NOTION_TOKEN:
+        print("❌ NOTION_TOKEN not set. Run:")
+        print('   export NOTION_TOKEN="your-token-here"')
+        print("\nGet a token at: https://www.notion.so/my-integrations")
+        sys.exit(1)
+
+    # Build properties
+    properties = {
+        "Task name": {
+            "title": [{"text": {"content": name}}]
+        },
+        "Status": {
+            "status": {"name": "Inbox"}
+        },
+        "Priority": {
+            "select": {"name": priority}
+        },
+        "Source": {
+            "select": {"name": source}
+        },
+    }
+
+    if project:
+        properties["Project"] = {"select": {"name": project}}
+
+    if area:
+        properties["Area"] = {"select": {"name": area}}
+
+    if due_date:
+        properties["Due date"] = {"date": {"start": parse_date(due_date)}}
+
+    if description:
+        properties["Description"] = {
+            "rich_text": [{"text": {"content": description}}]
+        }
+
+    data = {
+        "parent": {"database_id": DATABASE_ID},
+        "properties": properties,
+    }
+
+    # Make request using urllib (built-in)
+    req = urllib.request.Request(
+        "https://api.notion.com/v1/pages",
+        data=json.dumps(data).encode("utf-8"),
+        headers={
+            "Authorization": f"Bearer {NOTION_TOKEN}",
+            "Content-Type": "application/json",
+            "Notion-Version": "2022-06-28",
+        },
+        method="POST",
+    )
+
+    try:
+        with urllib.request.urlopen(req) as response:
+            result = json.loads(response.read().decode("utf-8"))
+            url = result.get("url", "")
+            print(f"✅ Created: {name}")
+            if project:
+                print(f"   Project: {project}")
+            if due_date:
+                print(f"   Due: {parse_date(due_date)}")
+            print(f"   {url}")
+    except urllib.error.HTTPError as e:
+        error_body = json.loads(e.read().decode("utf-8"))
+        print(f"❌ Error: {e.code}")
+        print(error_body.get("message", str(error_body)))
+
+
+def list_projects():
+    """List available projects."""
+    print("Available projects:")
+    for p in PROJECTS:
+        print(f"  - {p}")
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Quick task entry for Notion",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  task "Review [Journal] feedback"
+  task "Email [Supervisor] about results" -p "Journal Revision" --priority high
+  task "Read Smith 2024 paper" -p "[Project]" -d friday
+  task "Submit expenses" -p "Personal Admin" -d tomorrow
+        """,
+    )
+
+    parser.add_argument("name", nargs="?", help="Task description")
+    parser.add_argument("-p", "--project", help="Project name")
+    parser.add_argument("--priority", choices=["high", "medium", "low"], default="medium")
+    parser.add_argument("-d", "--due", help="Due date (today, tomorrow, friday, 2024-01-15)")
+    parser.add_argument("-s", "--source", default="Self-initiated")
+    parser.add_argument("-a", "--area", choices=["research", "teaching", "career", "personal", "health", "learning"],
+                        help="Area of responsibility")
+    parser.add_argument("--desc", help="Additional description")
+    parser.add_argument("--list-projects", action="store_true", help="List available projects")
+
+    args = parser.parse_args()
+
+    if args.list_projects:
+        list_projects()
+        return
+
+    if not args.name:
+        parser.print_help()
+        return
+
+    create_task(
+        name=args.name,
+        project=args.project,
+        priority=args.priority.capitalize(),
+        due_date=args.due,
+        source=args.source,
+        area=args.area.capitalize() if args.area else None,
+        description=args.desc,
+    )
+
+
+if __name__ == "__main__":
+    main()

package/.scripts/tasks

@@ -0,0 +1,190 @@
+#!/usr/bin/env python3
+"""
+Query and list tasks from Notion Tasks Tracker.
+
+Usage:
+    tasks                     # Show all active tasks
+    tasks --overdue           # Show overdue tasks
+    tasks --today             # Show tasks due today
+    tasks -p "Journal Revision"  # Filter by project
+    tasks --priority high     # Filter by priority
+"""
+
+import argparse
+import json
+import os
+import sys
+import urllib.request
+import urllib.error
+from datetime import datetime
+
+
+NOTION_TOKEN = os.environ.get("NOTION_TOKEN")
+DATABASE_ID = "YOUR-TASKS-DATABASE-ID-HERE"
+
+
+def query_tasks(filter_obj=None, sorts=None):
+    """Query tasks from Notion."""
+    if not NOTION_TOKEN:
+        print("❌ NOTION_TOKEN not set")
+        sys.exit(1)
+
+    data = {}
+    if filter_obj:
+        data["filter"] = filter_obj
+    if sorts:
+        data["sorts"] = sorts
+
+    req = urllib.request.Request(
+        f"https://api.notion.com/v1/databases/{DATABASE_ID}/query",
+        data=json.dumps(data).encode("utf-8") if data else b"{}",
+        headers={
+            "Authorization": f"Bearer {NOTION_TOKEN}",
+            "Content-Type": "application/json",
+            "Notion-Version": "2022-06-28",
+        },
+        method="POST",
+    )
+
+    try:
+        with urllib.request.urlopen(req) as response:
+            return json.loads(response.read().decode("utf-8"))
+    except urllib.error.HTTPError as e:
+        error_body = json.loads(e.read().decode("utf-8"))
+        print(f"❌ Error: {e.code}")
+        print(error_body.get("message", str(error_body)))
+        sys.exit(1)
+
+
+def get_property(page, prop_name, prop_type):
+    """Extract property value from a Notion page."""
+    prop = page.get("properties", {}).get(prop_name, {})
+
+    if prop_type == "title":
+        title_list = prop.get("title", [])
+        return title_list[0].get("plain_text", "") if title_list else ""
+    elif prop_type == "select":
+        select = prop.get("select")
+        return select.get("name", "") if select else ""
+    elif prop_type == "status":
+        status = prop.get("status")
+        return status.get("name", "") if status else ""
+    elif prop_type == "date":
+        date = prop.get("date")
+        return date.get("start", "") if date else ""
+    elif prop_type == "rich_text":
+        text_list = prop.get("rich_text", [])
+        return text_list[0].get("plain_text", "") if text_list else ""
+    return ""
+
+
+def format_task(page):
+    """Format a task for display."""
+    name = get_property(page, "Task name", "title")
+    status = get_property(page, "Status", "status")
+    priority = get_property(page, "Priority", "select")
+    project = get_property(page, "Project", "select")
+    due = get_property(page, "Due date", "date")
+
+    priority_emoji = {"High": "🔴", "Medium": "🟡", "Low": "🟢"}.get(priority, "⚪")
+    status_emoji = {"Done": "✅", "In progress": "🔄", "Waiting": "⏳", "Not started": "⬜"}.get(status, "⬜")
+
+    line = f"{status_emoji} {priority_emoji} {name}"
+    if project:
+        line += f" [{project}]"
+    if due:
+        line += f" (due: {due})"
+
+    return line
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Query tasks from Notion")
+    parser.add_argument("--overdue", action="store_true", help="Show overdue tasks")
+    parser.add_argument("--today", action="store_true", help="Show tasks due today")
+    parser.add_argument("--week", action="store_true", help="Show tasks due this week")
+    parser.add_argument("-p", "--project", help="Filter by project")
+    parser.add_argument("--priority", choices=["high", "medium", "low"], help="Filter by priority")
+    parser.add_argument("--status", help="Filter by status")
+    parser.add_argument("--all", action="store_true", help="Include completed tasks")
+    parser.add_argument("--limit", type=int, default=20, help="Max results (default: 20)")
+
+    args = parser.parse_args()
+
+    # Build filter
+    filters = []
+    today = datetime.now().strftime("%Y-%m-%d")
+
+    # Exclude done unless --all
+    if not args.all:
+        filters.append({
+            "property": "Status",
+            "status": {"does_not_equal": "Done"}
+        })
+
+    if args.overdue:
+        filters.append({
+            "property": "Due date",
+            "date": {"before": today}
+        })
+
+    if args.today:
+        filters.append({
+            "property": "Due date",
+            "date": {"equals": today}
+        })
+
+    if args.project:
+        filters.append({
+            "property": "Project",
+            "select": {"equals": args.project}
+        })
+
+    if args.priority:
+        filters.append({
+            "property": "Priority",
+            "select": {"equals": args.priority.capitalize()}
+        })
+
+    if args.status:
+        filters.append({
+            "property": "Status",
+            "status": {"equals": args.status}
+        })
+
+    filter_obj = None
+    if len(filters) == 1:
+        filter_obj = filters[0]
+    elif len(filters) > 1:
+        filter_obj = {"and": filters}
+
+    # Sort by due date, then priority
+    sorts = [
+        {"property": "Due date", "direction": "ascending"},
+        {"property": "Priority", "direction": "ascending"},
+    ]
+
+    result = query_tasks(filter_obj, sorts)
+    pages = result.get("results", [])[:args.limit]
+
+    if not pages:
+        print("No tasks found.")
+        return
+
+    # Print header
+    if args.overdue:
+        print(f"⚠️  Overdue Tasks ({len(pages)})")
+    elif args.today:
+        print(f"📅 Due Today ({len(pages)})")
+    elif args.project:
+        print(f"📁 {args.project} ({len(pages)})")
+    else:
+        print(f"📋 Tasks ({len(pages)})")
+    print("-" * 40)
+
+    for page in pages:
+        print(format_task(page))
+
+
+if __name__ == "__main__":
+    main()

package/.scripts/week

@@ -0,0 +1,206 @@
+#!/usr/bin/env python3
+"""
+Generate weekly summary from Notion tasks.
+
+Usage:
+    week                # Show this week's summary
+    week --last         # Show last week's summary
+"""
+
+import argparse
+import json
+import os
+import sys
+import urllib.request
+import urllib.error
+from datetime import datetime, timedelta
+
+
+NOTION_TOKEN = os.environ.get("NOTION_TOKEN")
+DATABASE_ID = "YOUR-TASKS-DATABASE-ID-HERE"
+
+
+def get_week_range(last_week=False):
+    """Get start and end of current or last week."""
+    today = datetime.now()
+
+    # Start of current week (Monday)
+    start_of_week = today - timedelta(days=today.weekday())
+
+    if last_week:
+        start_of_week = start_of_week - timedelta(days=7)
+
+    end_of_week = start_of_week + timedelta(days=6)
+
+    return start_of_week.strftime("%Y-%m-%d"), end_of_week.strftime("%Y-%m-%d")
+
+
+def query_tasks(filter_obj):
+    """Query tasks from Notion."""
+    if not NOTION_TOKEN:
+        print("❌ NOTION_TOKEN not set")
+        sys.exit(1)
+
+    data = {"filter": filter_obj}
+
+    req = urllib.request.Request(
+        f"https://api.notion.com/v1/databases/{DATABASE_ID}/query",
+        data=json.dumps(data).encode("utf-8"),
+        headers={
+            "Authorization": f"Bearer {NOTION_TOKEN}",
+            "Content-Type": "application/json",
+            "Notion-Version": "2022-06-28",
+        },
+        method="POST",
+    )
+
+    try:
+        with urllib.request.urlopen(req) as response:
+            return json.loads(response.read().decode("utf-8"))
+    except urllib.error.HTTPError as e:
+        error_body = json.loads(e.read().decode("utf-8"))
+        print(f"❌ Error: {e.code}")
+        print(error_body.get("message", str(error_body)))
+        sys.exit(1)
+
+
+def get_property(page, prop_name, prop_type):
+    """Extract property value from a Notion page."""
+    prop = page.get("properties", {}).get(prop_name, {})
+
+    if prop_type == "title":
+        title_list = prop.get("title", [])
+        return title_list[0].get("plain_text", "") if title_list else ""
+    elif prop_type == "select":
+        select = prop.get("select")
+        return select.get("name", "") if select else ""
+    elif prop_type == "status":
+        status = prop.get("status")
+        return status.get("name", "") if status else ""
+    elif prop_type == "date":
+        date = prop.get("date")
+        return date.get("start", "") if date else ""
+    return ""
+
+
+def format_task(page):
+    """Format a task for display."""
+    title = get_property(page, "Task name", "title")
+    project = get_property(page, "Project", "select")
+
+    line = f"  • {title}"
+    if project:
+        line += f" [{project}]"
+
+    return line
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Weekly summary")
+    parser.add_argument("--last", action="store_true", help="Show last week instead")
+
+    args = parser.parse_args()
+
+    start_date, end_date = get_week_range(args.last)
+    today = datetime.now().strftime("%Y-%m-%d")
+
+    # Header
+    if args.last:
+        print(f"📅 Last Week ({start_date} to {end_date})")
+    else:
+        print(f"📅 This Week ({start_date} to {end_date})")
+    print("=" * 50)
+
+    # Completed tasks (status = Done, check last_edited_time in range)
+    # Note: We'll query Done tasks and filter by those edited this week
+    completed_result = query_tasks({
+        "property": "Status",
+        "status": {"equals": "Done"}
+    })
+    completed_pages = completed_result.get("results", [])
+
+    # Filter by last_edited_time (rough proxy for completion date)
+    completed_this_week = []
+    for page in completed_pages:
+        edited = page.get("last_edited_time", "")[:10]
+        if start_date <= edited <= end_date:
+            completed_this_week.append(page)
+
+    print(f"\n✅ Completed ({len(completed_this_week)})")
+    print("-" * 30)
+    if completed_this_week:
+        for page in completed_this_week[:15]:
+            print(format_task(page))
+        if len(completed_this_week) > 15:
+            print(f"  ... and {len(completed_this_week) - 15} more")
+    else:
+        print("  (none)")
+
+    # Due this week (not done)
+    due_result = query_tasks({
+        "and": [
+            {"property": "Status", "status": {"does_not_equal": "Done"}},
+            {"property": "Due date", "date": {"on_or_after": start_date}},
+            {"property": "Due date", "date": {"on_or_before": end_date}}
+        ]
+    })
+    due_pages = due_result.get("results", [])
+
+    print(f"\n📋 Due This Week ({len(due_pages)})")
+    print("-" * 30)
+    if due_pages:
+        for page in due_pages:
+            due = get_property(page, "Due date", "date")
+            title = get_property(page, "Task name", "title")
+            project = get_property(page, "Project", "select")
+
+            overdue = "⚠️ " if due < today else ""
+            line = f"  {overdue}• {title}"
+            if project:
+                line += f" [{project}]"
+            line += f" (due: {due})"
+            print(line)
+    else:
+        print("  (none)")
+
+    # Overdue
+    overdue_result = query_tasks({
+        "and": [
+            {"property": "Status", "status": {"does_not_equal": "Done"}},
+            {"property": "Due date", "date": {"before": today}}
+        ]
+    })
+    overdue_pages = overdue_result.get("results", [])
+
+    if overdue_pages:
+        print(f"\n⚠️  Overdue ({len(overdue_pages)})")
+        print("-" * 30)
+        for page in overdue_pages[:10]:
+            print(format_task(page))
+        if len(overdue_pages) > 10:
+            print(f"  ... and {len(overdue_pages) - 10} more")
+
+    # In Progress
+    in_progress_result = query_tasks({
+        "property": "Status",
+        "status": {"equals": "In progress"}
+    })
+    in_progress_pages = in_progress_result.get("results", [])
+
+    if in_progress_pages:
+        print(f"\n🔄 In Progress ({len(in_progress_pages)})")
+        print("-" * 30)
+        for page in in_progress_pages:
+            print(format_task(page))
+
+    # Summary stats
+    print("\n" + "=" * 50)
+    print("Summary:")
+    print(f"  Completed: {len(completed_this_week)}")
+    print(f"  Due this week: {len(due_pages)}")
+    print(f"  Overdue: {len(overdue_pages)}")
+    print(f"  In progress: {len(in_progress_pages)}")
+
+
+if __name__ == "__main__":
+    main()