@kortix/sandbox 0.4.1

package/opencode/skills/KORTIX-legal-writer/references/document-types.md

@@ -0,0 +1,416 @@
+# Legal Document Type Reference
+
+Structure templates for each major document type. These are the **required sections and conventions** — adapt as needed for jurisdiction and context.
+
+## Legal Memorandum (Internal Memo)
+
+Objective, predictive analysis. Work product — privileged.
+
+```
+MEMORANDUM
+
+TO:       [Recipient Name, Title]
+FROM:     [Author Name, Title]
+DATE:     [Date]
+RE:       [Client] — [Subject]
+─────────────────────────────────────
+
+I.   QUESTION PRESENTED
+     - Phrased as yes/no question
+     - Combines: legal standard + key facts + jurisdiction
+     - "Under [law], does/is [legal question] when [key facts]?"
+
+II.  BRIEF ANSWER
+     - "Probably yes/no."
+     - State the rule in 1-2 sentences
+     - Apply rule to key facts briefly
+     - 3-5 sentences total
+
+III. STATEMENT OF FACTS
+     - Objective, chronological
+     - All legally relevant facts
+     - No legal conclusions
+     - Identify the client, claims at issue
+
+IV.  DISCUSSION
+     - IRAC/CREAC structure for each issue:
+       * Issue identification
+       * Rule (synthesized from authorities)
+       * Application (rule to facts)
+       * Conclusion
+     - Acknowledge counter-arguments
+     - Support every assertion with authority
+
+V.   CONCLUSION
+     - Summarize predictions
+     - Recommend next steps / strategy
+```
+
+## Legal Brief (Motion / Appellate)
+
+Persuasive. Advocates for a position.
+
+```
+[COURT CAPTION]
+
+I.    INTRODUCTION / PRELIMINARY STATEMENT
+      - 1-2 pages: why you win, plainly stated
+
+II.   STATEMENT OF ISSUES PRESENTED
+      - Questions for the court, framed favorably
+
+III.  STATEMENT OF FACTS / STATEMENT OF THE CASE
+      - Persuasive but accurate
+      - Cite to the record: (R. at 45), (Compl. ¶ 12)
+      - Chronological or thematic
+
+IV.   SUMMARY OF ARGUMENT
+      - 1-3 pages: main lines without detail
+
+V.    ARGUMENT
+      - Headings as complete persuasive sentences
+      - Standard of review first
+      - Each point: heading → standard → authority → application
+      - Counter-arguments addressed
+
+VI.   CONCLUSION
+      - Specific relief requested
+      - "For the foregoing reasons, [Party] respectfully
+        requests that this Court [specific relief]."
+
+CERTIFICATE OF COMPLIANCE (word count)
+PROOF OF SERVICE
+```
+
+## Contract / Agreement
+
+```
+[TITLE OF AGREEMENT]
+
+PREAMBLE
+  - Date of agreement
+  - Parties: full legal name, entity type, jurisdiction, address
+  - Short names: ("Company"), ("Contractor")
+
+RECITALS / BACKGROUND
+  A. [Context of the transaction]
+  B. [Purpose]
+  C. [Desire of the parties]
+  "The parties therefore agree as follows:"
+
+ARTICLE 1: DEFINITIONS
+  - Alphabetical order
+  - "Term" means [definition].
+  - All capitalized terms
+
+ARTICLE 2: [CORE OBLIGATIONS]
+  2.1 [Primary obligation]
+  2.2 [Secondary obligation]
+
+ARTICLE 3: COMPENSATION / CONSIDERATION
+  3.1 Fees / Price
+  3.2 Payment terms
+  3.3 Taxes
+
+ARTICLE 4: TERM AND TERMINATION
+  4.1 Term / Effective Date
+  4.2 Termination for Cause
+  4.3 Termination for Convenience
+  4.4 Effect of Termination
+  4.5 Survival
+
+ARTICLE 5: REPRESENTATIONS AND WARRANTIES
+
+ARTICLE 6: INDEMNIFICATION
+  6.1 Indemnification by [Party A]
+  6.2 Indemnification by [Party B]
+  6.3 Indemnification Procedures
+
+ARTICLE 7: LIMITATION OF LIABILITY
+
+ARTICLE 8: CONFIDENTIALITY
+
+ARTICLE 9: INTELLECTUAL PROPERTY
+
+ARTICLE 10: GENERAL PROVISIONS
+  10.1  Entire Agreement
+  10.2  Amendment (written only)
+  10.3  Waiver
+  10.4  Severability
+  10.5  Assignment
+  10.6  Notices
+  10.7  Governing Law
+  10.8  Dispute Resolution
+  10.9  Force Majeure
+  10.10 Counterparts
+
+SIGNATURE BLOCKS
+  [Party A]
+  By: _________________________
+  Name:
+  Title:
+  Date:
+
+  [Party B]
+  By: _________________________
+  Name:
+  Title:
+  Date:
+
+EXHIBITS / SCHEDULES
+```
+
+## Complaint / Petition
+
+```
+[COURT NAME]
+
+[Plaintiff(s)],
+        Plaintiff(s),
+v.                                    Case No. ____________
+[Defendant(s)],
+        Defendant(s).
+
+COMPLAINT FOR [CAUSE(S) OF ACTION]
+
+I. INTRODUCTION
+   1.  [Brief overview — 1-2 paragraphs]
+
+II. JURISDICTION AND VENUE
+    2.  [Subject matter jurisdiction — cite statute]
+    3.  [Personal jurisdiction]
+    4.  [Venue — cite statute]
+
+III. PARTIES
+     5.  [Plaintiff identification]
+     6.  [Defendant identification]
+
+IV. STATEMENT OF FACTS
+    7.  [Chronological, numbered paragraphs]
+    8.  [Each paragraph = one factual assertion]
+    ...
+
+V. CAUSES OF ACTION
+
+   COUNT I: [Cause of Action]
+   20. Plaintiff re-alleges and incorporates ¶¶ 1-19.
+   21. [Elements of the claim]
+   22. [Facts satisfying each element]
+
+   COUNT II: [Next Cause of Action]
+   ...
+
+VI. PRAYER FOR RELIEF
+    WHEREFORE, Plaintiff respectfully requests:
+    a. Compensatory damages in an amount to be proven at trial;
+    b. Punitive damages;
+    c. Costs and attorneys' fees;
+    d. Such other relief as the Court deems just.
+
+VII. DEMAND FOR JURY TRIAL
+     Plaintiff demands a trial by jury.
+
+[Signature block]
+[Verification if required]
+```
+
+## Demand Letter
+
+```
+[FIRM LETTERHEAD]
+[Date]
+
+VIA [CERTIFIED MAIL / EMAIL]
+
+[Recipient]
+[Address]
+
+Re: [Description of Claim]
+
+Dear [Recipient]:
+
+[Introduction — who you represent, purpose]
+
+[Statement of Facts — chronological, specific]
+
+[Legal Basis — applicable law, breach, liability theory]
+
+[Damages — specific amount, breakdown]
+
+[Demand — action required, deadline (10-30 days), consequences]
+
+[Closing — willingness to discuss, contact info]
+
+Sincerely,
+
+[Attorney Name]
+[Bar Number]
+[Contact Information]
+
+cc: [if applicable]
+Enclosures: [if applicable]
+```
+
+## Settlement Agreement
+
+```
+SETTLEMENT AGREEMENT AND RELEASE
+
+1.  PARTIES
+2.  RECITALS
+    - Description of dispute / litigation
+    - Desire to resolve
+3.  DEFINITIONS
+4.  SETTLEMENT TERMS
+    - Payment amount, timing, method
+    - Non-monetary terms
+5.  RELEASE OF CLAIMS
+    - Scope (known and unknown)
+    - Mutual or one-way
+    - Statutory waivers
+6.  DISMISSAL
+    - With/without prejudice
+    - Timeline, responsibility
+7.  REPRESENTATIONS AND WARRANTIES
+8.  CONFIDENTIALITY
+9.  NON-DISPARAGEMENT
+10. NON-ADMISSION OF LIABILITY
+11. GENERAL PROVISIONS
+12. SIGNATURE BLOCKS
+```
+
+## Discovery Requests
+
+### Interrogatories
+```
+[COURT CAPTION]
+
+[PARTY]'S FIRST SET OF INTERROGATORIES TO [PARTY]
+
+Pursuant to [Rule]:
+
+I.   DEFINITIONS
+     "DOCUMENT" means... "IDENTIFY" means... "COMMUNICATION" means...
+
+II.  INSTRUCTIONS
+     Time period, form of response, duty to supplement
+
+III. INTERROGATORIES
+     Interrogatory No. 1:  [Question]
+     Interrogatory No. 2:  [Question]
+     ... (Federal limit: 25 including subparts)
+
+[Signature, date, certificate of service]
+```
+
+### Requests for Production
+```
+[COURT CAPTION]
+
+[PARTY]'S FIRST SET OF REQUESTS FOR PRODUCTION
+
+I.   DEFINITIONS
+II.  INSTRUCTIONS
+III. REQUESTS
+     Request No. 1: All DOCUMENTS relating to...
+     Request No. 2: ...
+
+[Signature, date, certificate of service]
+```
+
+## Legal Opinion Letter
+
+```
+[FIRM LETTERHEAD]
+[Date]
+
+[Addressee]
+
+Re: [Transaction Description]
+
+Ladies and Gentlemen:
+
+1. INTRODUCTION
+   - Scope of engagement, transaction identification
+
+2. DOCUMENTS REVIEWED
+   - Enumerated list of all documents examined
+
+3. ASSUMPTIONS
+   - Facts assumed without independent verification
+
+4. OPINIONS
+   1. [Entity] is duly organized and validly existing...
+   2. [Entity] has the corporate authority to execute...
+   3. The Agreement constitutes a valid and binding obligation...
+   4. The execution and delivery do not conflict with...
+   [Each opinion as a numbered paragraph]
+
+5. QUALIFICATIONS AND LIMITATIONS
+   - Jurisdictional scope
+   - Bankruptcy/insolvency carve-outs
+   - Equitable principles qualification
+
+6. RELIANCE
+   - Who may rely on this opinion
+   - Distribution restrictions
+
+Very truly yours,
+
+[Firm Name]
+```
+
+## Terms of Service
+
+```
+TERMS OF SERVICE
+Last Updated: [Date]
+
+1.  Acceptance of Terms
+2.  Description of Service
+3.  User Accounts and Registration
+4.  User Conduct / Acceptable Use
+5.  Intellectual Property Rights
+6.  User-Generated Content (license grant)
+7.  Payment Terms (if applicable)
+8.  Termination
+9.  Disclaimers (AS-IS, NO WARRANTY)
+10. Limitation of Liability (cap on damages)
+11. Indemnification
+12. Governing Law and Jurisdiction
+13. Dispute Resolution / Arbitration
+14. Class Action Waiver
+15. Modifications to Terms
+16. Severability
+17. Entire Agreement
+18. Contact Information
+```
+
+## Privacy Policy
+
+```
+PRIVACY POLICY
+Effective Date: [Date]
+
+1.  Introduction / Who We Are
+2.  Information We Collect
+    a. Information You Provide
+    b. Information Collected Automatically
+    c. Information from Third Parties
+3.  How We Use Your Information
+4.  How We Share Your Information
+5.  Cookies and Tracking Technologies
+6.  Data Retention
+7.  Data Security
+8.  Your Rights and Choices
+    a. Access and Portability
+    b. Correction
+    c. Deletion
+    d. Opt-Out (marketing, sale of data)
+9.  Children's Privacy (COPPA)
+10. International Data Transfers
+11. California Privacy Rights (CCPA/CPRA)
+12. EU/EEA Privacy Rights (GDPR)
+13. Changes to This Policy
+14. Contact Information / DPO
+```

package/opencode/skills/KORTIX-legal-writer/scripts/courtlistener.py

@@ -0,0 +1,291 @@
+#!/usr/bin/env python3
+"""CourtListener API client for case law lookup.
+
+Search and retrieve case law from the Free Law Project's CourtListener database.
+Millions of legal opinions across federal and state courts.
+
+Usage:
+    # Search for cases
+    python3 courtlistener.py search "qualified immunity police"
+    python3 courtlistener.py search "breach of contract damages" --court "scotus"
+    python3 courtlistener.py search "first amendment speech" --after 2020
+
+    # Get a specific opinion by ID
+    python3 courtlistener.py opinion 12345
+
+    # Get citation details
+    python3 courtlistener.py cite 12345
+
+    # Format a citation in Bluebook style
+    python3 courtlistener.py bluebook 12345
+
+API docs: https://www.courtlistener.com/api/rest/v4/
+Auth: Set COURTLISTENER_API_TOKEN env var (free account at courtlistener.com)
+      Without token: limited to 100 requests/day
+      With token: 5,000 requests/day
+
+Output: JSON to stdout (pipe to jq for formatting).
+"""
+
+import sys
+import json
+import os
+import urllib.request
+import urllib.parse
+import urllib.error
+
+BASE_URL = "https://www.courtlistener.com/api/rest/v4"
+
+def get_headers():
+    """Get auth headers if token is available."""
+    headers = {"Content-Type": "application/json"}
+    token = os.environ.get("COURTLISTENER_API_TOKEN", "")
+    if token:
+        headers["Authorization"] = f"Token {token}"
+    return headers
+
+
+def api_get(endpoint, params=None):
+    """Make a GET request to CourtListener API."""
+    url = f"{BASE_URL}/{endpoint}/"
+    if params:
+        url += "?" + urllib.parse.urlencode(params)
+
+    req = urllib.request.Request(url, headers=get_headers())
+    try:
+        with urllib.request.urlopen(req) as resp:
+            return json.loads(resp.read())
+    except urllib.error.HTTPError as e:
+        error_body = e.read().decode() if e.fp else ""
+        print(json.dumps({
+            "error": f"HTTP {e.code}: {e.reason}",
+            "detail": error_body[:500],
+            "url": url,
+            "hint": "Get a free API token at https://www.courtlistener.com/sign-in/"
+                    if e.code == 401 else ""
+        }), file=sys.stderr)
+        sys.exit(1)
+    except urllib.error.URLError as e:
+        print(json.dumps({"error": str(e)}), file=sys.stderr)
+        sys.exit(1)
+
+
+def search_opinions(query, court=None, after=None, before=None, limit=10):
+    """Search case law opinions.
+
+    Args:
+        query: Search terms
+        court: Court filter (e.g., "scotus", "ca9", "nyed")
+        after: Only cases after this year
+        before: Only cases before this year
+        limit: Max results (default 10)
+    """
+    params = {
+        "type": "o",  # opinions
+        "q": query,
+        "page_size": min(limit, 20),
+        "order_by": "score desc",
+    }
+    if court:
+        params["court"] = court
+    if after:
+        params["filed_after"] = f"{after}-01-01"
+    if before:
+        params["filed_before"] = f"{before}-12-31"
+
+    data = api_get("search", params)
+
+    # Simplify results for easy consumption
+    results = []
+    for r in data.get("results", []):
+        results.append({
+            "id": r.get("cluster_id") or r.get("id"),
+            "case_name": r.get("caseName", ""),
+            "court": r.get("court", ""),
+            "date_filed": r.get("dateFiled", ""),
+            "citation": r.get("citation", []),
+            "docket_number": r.get("docketNumber", ""),
+            "snippet": (r.get("snippet", "") or "")[:300],
+            "absolute_url": r.get("absolute_url", ""),
+        })
+
+    return {
+        "count": data.get("count", 0),
+        "results": results,
+    }
+
+
+def _search_by_id(cluster_id):
+    """Look up a case by cluster_id via the search endpoint (no auth required)."""
+    data = api_get("search", {"type": "o", "q": f"cluster_id:{cluster_id}", "page_size": 1})
+    results = data.get("results", [])
+    if not results:
+        # Fallback: try the clusters endpoint (requires auth)
+        try:
+            return api_get(f"clusters/{cluster_id}")
+        except SystemExit:
+            print(json.dumps({"error": f"Case {cluster_id} not found"}), file=sys.stderr)
+            sys.exit(1)
+    r = results[0]
+    return {
+        "cluster_id": r.get("cluster_id") or cluster_id,
+        "case_name": r.get("caseName", ""),
+        "court": r.get("court", ""),
+        "date_filed": r.get("dateFiled", ""),
+        "citations": r.get("citation", []),
+        "docket_number": r.get("docketNumber", ""),
+        "snippet": (r.get("snippet", "") or "")[:500],
+        "absolute_url": r.get("absolute_url", ""),
+        "judge": r.get("judge", ""),
+        "status": r.get("status", ""),
+    }
+
+
+def get_opinion(cluster_id):
+    """Get a specific opinion cluster (case) by ID.
+
+    Uses the search endpoint (no auth required) with cluster_id filter.
+    """
+    return _search_by_id(cluster_id)
+
+
+def get_citations(cluster_id):
+    """Get cases cited by a specific opinion.
+
+    Note: This endpoint requires authentication (API token).
+    """
+    data = api_get("opinions-cited", {"citing_opinion__cluster__id": cluster_id})
+    return data
+
+
+# Map of court IDs to Bluebook abbreviations
+COURT_ABBREVS = {
+    "Supreme Court of the United States": "",  # No court abbrev needed for SCOTUS
+    "scotus": "",
+    # Federal Circuit Courts
+    "Court of Appeals for the First Circuit": "1st Cir.",
+    "Court of Appeals for the Second Circuit": "2d Cir.",
+    "Court of Appeals for the Third Circuit": "3d Cir.",
+    "Court of Appeals for the Fourth Circuit": "4th Cir.",
+    "Court of Appeals for the Fifth Circuit": "5th Cir.",
+    "Court of Appeals for the Sixth Circuit": "6th Cir.",
+    "Court of Appeals for the Seventh Circuit": "7th Cir.",
+    "Court of Appeals for the Eighth Circuit": "8th Cir.",
+    "Court of Appeals for the Ninth Circuit": "9th Cir.",
+    "Court of Appeals for the Tenth Circuit": "10th Cir.",
+    "Court of Appeals for the Eleventh Circuit": "11th Cir.",
+    "Court of Appeals for the D.C. Circuit": "D.C. Cir.",
+    "Court of Appeals for the Federal Circuit": "Fed. Cir.",
+}
+
+
+def format_bluebook(cluster_id):
+    """Attempt to format a case citation in Bluebook style.
+
+    Uses the search endpoint (no auth required).
+    Returns a best-effort Bluebook citation based on available data.
+    Note: This is approximate — always verify against Bluebook rules.
+    """
+    data = _search_by_id(cluster_id)
+
+    case_name = data.get("case_name", "Unknown Case")
+    date_filed = data.get("date_filed", "")
+    year = date_filed[:4] if date_filed else "n.d."
+
+    citations = data.get("citations", [])
+    court = data.get("court", "")
+
+    # Get court abbreviation for Bluebook
+    court_abbrev = COURT_ABBREVS.get(court, "")
+    if not court_abbrev and court:
+        # Try to extract a short form
+        court_abbrev = court
+
+    # Build citation — prefer official reporters
+    # Priority: U.S. > S. Ct. > F.3d/F.4th > state reporters
+    cite_str = ""
+    for c in citations:
+        if isinstance(c, str):
+            # Check for preferred reporters
+            if " U.S. " in c:
+                cite_str = c
+                break
+            elif " S. Ct. " in c and not cite_str:
+                cite_str = c
+            elif (" F.3d " in c or " F.4th " in c or " F.2d " in c) and not cite_str:
+                cite_str = c
+            elif not cite_str:
+                cite_str = c
+
+    if cite_str:
+        # For U.S. reports, no court abbreviation needed
+        if " U.S. " in cite_str:
+            return f"{case_name}, {cite_str} ({year})."
+        else:
+            court_part = f"{court_abbrev} " if court_abbrev else ""
+            return f"{case_name}, {cite_str} ({court_part}{year})."
+    else:
+        court_part = f"{court_abbrev} " if court_abbrev else ""
+        docket = data.get("docket_number", "unknown")
+        return f"{case_name}, No. {docket} ({court_part}{year})."
+
+
+# ─── CLI ────────────────────────────────────────────────────────────────────
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage:", file=sys.stderr)
+        print("  courtlistener.py search <query> [--court <court>] [--after <year>] [--limit <n>]", file=sys.stderr)
+        print("  courtlistener.py opinion <cluster_id>", file=sys.stderr)
+        print("  courtlistener.py cite <cluster_id>", file=sys.stderr)
+        print("  courtlistener.py bluebook <cluster_id>", file=sys.stderr)
+        print("", file=sys.stderr)
+        print("Courts: scotus, ca1-ca11, cadc, cafc, nyed, sdny, cdca, ...", file=sys.stderr)
+        print("Auth: export COURTLISTENER_API_TOKEN=<your-token>", file=sys.stderr)
+        sys.exit(1)
+
+    command = sys.argv[1]
+
+    if command == "search":
+        if len(sys.argv) < 3:
+            print("Usage: courtlistener.py search <query> [--court <c>] [--after <y>] [--limit <n>]", file=sys.stderr)
+            sys.exit(1)
+        query = sys.argv[2]
+        court = None
+        after = None
+        limit = 10
+        i = 3
+        while i < len(sys.argv):
+            if sys.argv[i] == "--court" and i + 1 < len(sys.argv):
+                court = sys.argv[i + 1]; i += 2
+            elif sys.argv[i] == "--after" and i + 1 < len(sys.argv):
+                after = int(sys.argv[i + 1]); i += 2
+            elif sys.argv[i] == "--limit" and i + 1 < len(sys.argv):
+                limit = int(sys.argv[i + 1]); i += 2
+            else:
+                i += 1
+        result = search_opinions(query, court=court, after=after, limit=limit)
+        print(json.dumps(result, indent=2))
+
+    elif command == "opinion":
+        cluster_id = sys.argv[2]
+        result = get_opinion(cluster_id)
+        print(json.dumps(result, indent=2))
+
+    elif command == "cite":
+        cluster_id = sys.argv[2]
+        result = get_citations(cluster_id)
+        print(json.dumps(result, indent=2))
+
+    elif command == "bluebook":
+        cluster_id = sys.argv[2]
+        citation = format_bluebook(cluster_id)
+        print(citation)
+
+    else:
+        print(f"Unknown command: {command}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()