frontier-council 0.1.0__tar.gz → 0.1.2__tar.gz

frontier_council-0.1.2/.gitignore

@@ -0,0 +1,16 @@
+# History (may contain personal questions)
+council_history.jsonl
+
+# Local Claude config
+.claude/
+
+# Python
+__pycache__/
+*.py[cod]
+dist/
+build/
+*.egg-info/
+
+# IDE
+.vscode/
+.idea/

frontier_council-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Terry Li
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{frontier_council-0.1.0 → frontier_council-0.1.2}/PKG-INFO

@@ -1,10 +1,13 @@
 Metadata-Version: 2.4
 Name: frontier-council
-Version: 0.1.0
+Version: 0.1.2
 Summary: Multi-model deliberation for important decisions. 5 frontier LLMs debate, then a judge synthesizes consensus.
-Project-URL: Homepage, https://github.com/terry-li-hm/skills
+Project-URL: Homepage, https://github.com/terry-li-hm/frontier-council
+Project-URL: Repository, https://github.com/terry-li-hm/frontier-council
+Project-URL: Issues, https://github.com/terry-li-hm/frontier-council/issues
 Author-email: Terry Li <terry.li.hm@gmail.com>
 License-Expression: MIT
+License-File: LICENSE
 Keywords: ai,council,debate,deliberation,frontier,llm,multi-model,openrouter
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
@@ -77,8 +80,13 @@ frontier-council "Career question" --output transcript.md
 
 # Share via GitHub Gist
 frontier-council "Important decision" --share
+
+# List past sessions
+frontier-council --sessions
 ```
 
+All sessions are auto-saved to `~/.frontier-council/sessions/` for later review.
+
 ## Options
 
 | Flag | Description |
@@ -93,6 +101,8 @@ frontier-council "Important decision" --share
 | `--persona TEXT` | Context about the person asking |
 | `--advocate N` | Which speaker (1-5) should be devil's advocate (default: random) |
 | `--quiet` | Suppress progress output |
+| `--sessions` | List recent saved sessions |
+| `--no-save` | Don't auto-save transcript to ~/.frontier-council/sessions/ |
 
 ## How It Works
 

{frontier_council-0.1.0 → frontier_council-0.1.2}/README.md

@@ -57,8 +57,13 @@ frontier-council "Career question" --output transcript.md
 
 # Share via GitHub Gist
 frontier-council "Important decision" --share
+
+# List past sessions
+frontier-council --sessions
 ```
 
+All sessions are auto-saved to `~/.frontier-council/sessions/` for later review.
+
 ## Options
 
 | Flag | Description |
@@ -73,6 +78,8 @@ frontier-council "Important decision" --share
 | `--persona TEXT` | Context about the person asking |
 | `--advocate N` | Which speaker (1-5) should be devil's advocate (default: random) |
 | `--quiet` | Suppress progress output |
+| `--sessions` | List recent saved sessions |
+| `--no-save` | Don't auto-save transcript to ~/.frontier-council/sessions/ |
 
 ## How It Works
 

{frontier_council-0.1.0 → frontier_council-0.1.2}/frontier_council/__init__.py

@@ -1,6 +1,6 @@
 """Frontier Council - Multi-model deliberation for important decisions."""
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"
 
 from .council import (
     run_council,

{frontier_council-0.1.0 → frontier_council-0.1.2}/frontier_council/cli.py

@@ -4,11 +4,27 @@ import argparse
 import json
 import os
 import random
+import re
 import subprocess
 import sys
 from datetime import datetime
 from pathlib import Path
 
+
+def get_sessions_dir() -> Path:
+    """Get the sessions directory, creating if needed."""
+    sessions_dir = Path.home() / ".frontier-council" / "sessions"
+    sessions_dir.mkdir(parents=True, exist_ok=True)
+    return sessions_dir
+
+
+def slugify(text: str, max_len: int = 40) -> str:
+    """Convert text to a filename-safe slug."""
+    text = text.lower()
+    text = re.sub(r'[^\w\s-]', '', text)
+    text = re.sub(r'[\s_-]+', '-', text)
+    return text[:max_len].strip('-')
+
 from .council import (
     COUNCIL,
     detect_social_context,
@@ -78,8 +94,33 @@ Examples:
         choices=[1, 2, 3, 4, 5],
         help="Which speaker (1-5) should be devil's advocate (default: random)",
     )
+    parser.add_argument(
+        "--no-save",
+        action="store_true",
+        help="Don't auto-save transcript to ~/.frontier-council/sessions/",
+    )
+    parser.add_argument(
+        "--sessions",
+        action="store_true",
+        help="List recent sessions and exit",
+    )
     args = parser.parse_args()
 
+    # Handle --sessions flag
+    if args.sessions:
+        sessions_dir = get_sessions_dir()
+        sessions = sorted(sessions_dir.glob("*.md"), key=lambda p: p.stat().st_mtime, reverse=True)
+        if not sessions:
+            print("No sessions found.")
+        else:
+            print(f"Sessions in {sessions_dir}:\n")
+            for s in sessions[:20]:  # Show last 20
+                mtime = datetime.fromtimestamp(s.stat().st_mtime).strftime("%Y-%m-%d %H:%M")
+                print(f"  {mtime}  {s.name}")
+            if len(sessions) > 20:
+                print(f"\n  ... and {len(sessions) - 20} more")
+        sys.exit(0)
+
     # Auto-detect social context if not explicitly set
     social_mode = args.social or detect_social_context(args.question)
     if social_mode and not args.social and not args.quiet:
@@ -153,12 +194,38 @@ Examples:
             print("=" * 60)
             print()
 
-        # Save transcript
+        # Save transcript to user-specified location
         if args.output:
             Path(args.output).write_text(transcript)
             if not args.quiet:
                 print(f"Transcript saved to: {args.output}")
 
+        # Auto-save to sessions directory
+        session_path = None
+        if not args.no_save:
+            timestamp = datetime.now().strftime("%Y%m%d-%H%M%S")
+            slug = slugify(args.question)
+            filename = f"{timestamp}-{slug}.md"
+            session_path = get_sessions_dir() / filename
+
+            # Build full session content with metadata header
+            session_content = f"""# Council Session
+
+**Question:** {args.question}
+**Date:** {datetime.now().strftime("%Y-%m-%d %H:%M")}
+**Rounds:** {args.rounds}
+**Mode:** {"named" if args.named else "anonymous"}, {"blind" if use_blind else "no blind"}{", social" if social_mode else ""}
+{f"**Context:** {args.context}" if args.context else ""}
+{f"**Persona:** {args.persona}" if args.persona else ""}
+
+---
+
+{transcript}
+"""
+            session_path.write_text(session_content)
+            if not args.quiet:
+                print(f"Session saved to: {session_path}")
+
         # Share via gist
         gist_url = None
         if args.share:
@@ -190,10 +257,11 @@ Examples:
                 print("Error: 'gh' CLI not found. Install with: brew install gh", file=sys.stderr)
 
         # Log to history
-        history_file = Path(__file__).parent.parent / "council_history.jsonl"
+        history_file = get_sessions_dir().parent / "history.jsonl"
         log_entry = {
             "timestamp": datetime.now().isoformat(),
             "question": args.question[:200],
+            "session": str(session_path) if session_path else None,
             "gist": gist_url,
             "context": args.context,
             "rounds": args.rounds,

{frontier_council-0.1.0 → frontier_council-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "frontier-council"
-version = "0.1.0"
+version = "0.1.2"
 description = "Multi-model deliberation for important decisions. 5 frontier LLMs debate, then a judge synthesizes consensus."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -27,7 +27,9 @@ dependencies = [
 frontier-council = "frontier_council.cli:main"
 
 [project.urls]
-Homepage = "https://github.com/terry-li-hm/skills"
+Homepage = "https://github.com/terry-li-hm/frontier-council"
+Repository = "https://github.com/terry-li-hm/frontier-council"
+Issues = "https://github.com/terry-li-hm/frontier-council/issues"
 
 [build-system]
 requires = ["hatchling"]

frontier_council-0.1.0/SKILL.md

@@ -1,87 +0,0 @@
----
-name: llm-council
-description: LLM Council with 5 frontier models (Opus 4.5, GPT-5.2, Gemini 3 Pro, Grok 4, Kimi K2.5). Models deliberate on a question, each seeing previous responses, then a judge synthesizes consensus. Use for important decisions needing diverse AI perspectives.
----
-
-# LLM Council
-
-5 frontier models deliberate on a question. Unlike `/ask-llms` which shows parallel responses, this creates an actual debate where models see and respond to previous speakers, followed by a judge synthesizing the consensus.
-
-## When to Use
-
-- Important decisions that benefit from diverse perspectives
-- You want models to actually debate, not just answer in parallel
-- You need a synthesized recommendation, not raw comparison
-- Exploring trade-offs where different viewpoints matter
-
-## When NOT to Use
-
-- **Thinking out loud** — exploratory discussions where you're still forming the question
-- **Claude has good context** — if we've been discussing the topic, direct conversation is faster
-- **Personal preference** — council excels at objective trade-offs, not "what would I enjoy"
-- **Already converged** — if discussion reached a conclusion, council just validates
-- **Speed matters** — takes 60-90s and costs several dollars
-
-## Prerequisites
-
-```bash
-export OPENROUTER_API_KEY=sk-or-v1-...    # Required
-export GOOGLE_API_KEY=AIza...              # Optional: Gemini fallback
-export MOONSHOT_API_KEY=sk-...             # Optional: Kimi fallback
-```
-
-## Instructions
-
-### Step 1: Get the Question
-
-Ask the user what question they want the council to deliberate, or use the question they provided.
-
-### Step 2: Run the Council
-
-```bash
-llm-council "Should we use microservices or a monolith for this project?"
-```
-
-**Common options:**
-```bash
-llm-council "question" --social              # Interview/networking questions
-llm-council "question" --persona "context"   # Add personal context
-llm-council "question" --rounds 3            # More deliberation
-llm-council "question" --output file.md      # Save transcript
-llm-council "question" --share               # Upload to secret Gist
-```
-
-### Step 3: Review and Critique
-
-Present the judge's synthesis, then critique it:
-- Did the council overcorrect on any point?
-- Did they miss obvious scenarios?
-- Does the advice fit the user's specific context?
-- Any groupthink where everyone agreed too fast?
-
-## Prompting Tips
-
-**For social/conversational contexts** (interview questions, networking, outreach):
-
-LLMs over-optimize for thoroughness. Add constraints like:
-- "Make it feel like a natural conversation"
-- "Something you'd actually ask over coffee"
-- "Simple and human, not structured and comprehensive"
-
-**Match context depth to question type:**
-- Strategic decisions: provide rich context (full background, constraints, history)
-- Social questions: minimal context + clear tone constraints
-
-**For architecture/design questions:**
-
-Provide scale and constraints upfront to avoid premature optimization advice:
-- "This is a single-user system" (avoids multi-user concerns)
-- "We have 500 notes, not 50,000" (avoids scaling infrastructure)
-- "Manual processes are acceptable" (avoids automation overkill)
-
-Without these constraints, council tends to suggest infrastructure for problems that don't exist yet.
-
-## See Also
-
-- Full documentation: `cat /Users/terry/skills/llm-council/README.md`
-- Python API available: `from llm_council import run_council`

frontier_council-0.1.0/council_history.jsonl

@@ -1,21 +0,0 @@
-{"timestamp": "2026-01-20T20:40:06.696079", "question": "What is 2+2?", "context": null, "rounds": 1, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-20T21:19:53.101354", "question": "Terry has a persistent Claude Code setup (tmux, Obsidian vault, browser automation, background tasks). He's job hunting as a senior exec (Head of Data Science) being counselled out of a Hong Kong bank", "gist": null, "context": "AI autonomy for job hunting", "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-20T21:21:25.406704", "question": "Terry is job hunting after being counselled out of his Head of Data Science role at a bank in Hong Kong. He's using Claude Code as his AI assistant. Based on Ethan Mollick's insight that AI agents mak", "gist": null, "context": "job hunting strategy for senior data science leader", "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-21T14:49:02.706670", "question": "Should Terry reach out to Kelvin Chan (AGM, Head of Customer Intelligence at BOCHK) and if so, how direct should he be about job opportunities?\n\n**Context about Terry:**\n- Currently AGM & Head of Data", "gist": null, "context": "career networking decision under time pressure", "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-21T15:12:10.947338", "question": "Review this LinkedIn message from Terry to Kelvin Chan. Is it good to send as-is, or does it need refinement?\n\n**The message:**\n'Hi Kelvin, great connecting at the HKMA GenAI Sandbox graduation \u2014 cong", "gist": null, "context": "LinkedIn outreach message review", "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-22T07:52:14.589415", "question": "Terry is about to have his 3rd round interview at Capco (consulting firm) for a Principal Consultant, AI Solution Lead role. The interviewer is Marco Chiu, a Principal Consultant in Data - so a peer i", "gist": null, "context": "peer interview strategy", "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-22T08:05:15.654039", "question": "Terry has a peer interview at Capco with Marco Chiu (Principal Consultant, Data). He's been there 10+ years. Terry wants 1 question to ask at the end.\n\nConstraint: Make it feel like a natural conversa", "gist": null, "context": "peer interview question", "rounds": 1, "blind": false, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-22T11:47:56.997936", "question": "**Question:** Why is my job application-to-interview conversion rate low, and what should I change?\n\n**Context:**\n\nI'm Terry Li, AGM & Head of Data Science at China CITIC Bank International (Hong Kong", "gist": null, "context": "career strategy for senior data science leader in Hong Kong banking", "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-22T12:31:37.102976", "question": "Context: Terry Li is AGM & Head of Data Science at China CITIC Bank International (small Chinese bank HK subsidiary). He's being counselled out despite strong performance (Very Good ratings, Best Fint", "gist": null, "context": null, "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-22T13:45:32.943472", "question": "Final check on this LinkedIn reply before sending.\n\nContext: Terry (AGM at smaller bank CITIC, job hunting) is replying to Kelvin Chan (AGM, Head of Customer Intelligence at BOCHK \u2014 bigger tier-1 bank", "gist": null, "context": "networking reply", "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-22T14:16:55.519265", "question": "Given the commoditization of the tech stack (Python + Docker + DB covers most needs) and the rise of AI coding tools, what is the realistic competitive positioning for a senior technical person in Hon", "gist": null, "context": null, "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-23T15:20:19.552247", "question": "Terry is negotiating a Principal Consultant, AI Solution Lead role at Capco Hong Kong. He needs advice on compensation negotiation strategy.\n\n**Terry's situation:**\n- Currently AGM & Head of Data Scie", "gist": null, "context": null, "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-23T15:54:31.430621", "question": "Terry is considering accepting a Principal Consultant role at Capco Hong Kong as a 1-2 year 'bridge' strategy before returning to in-house banking. He wants the council to stress-test this plan.\n\n**Th", "gist": null, "context": null, "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-25T09:12:10.579975", "question": "Should a bank's customer-facing FAQ chatbot use LLM-generated answers (with guardrails) or stick with verbatim pre-approved answers?\n\n## Context\n\nTerry is building a POC chatbot for CITIC Bank Hong Ko", "gist": null, "context": null, "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-25T19:38:26.635861", "question": "How are AI coding agents (like Claude Code, Cursor, Copilot) affecting the landscape of software development? Consider impacts on: build vs buy economics, vendor relationships, team structures, skill ", "gist": null, "context": "business strategy discussion between banking executives", "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-26T14:12:01.575180", "question": "Gavin Maxwell (Capco recruiter) just messaged Terry on WhatsApp at 1:54 PM today:\n\n'Hi Terry, is your notice period negotiable?'\n'Or will you need to complete two months'\n\nContext:\n- Terry is at offer", "gist": null, "context": null, "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-27T06:28:25.073503", "question": "Terry is job hunting in Hong Kong (Head of Data Science level, ~HKD 1.78M total comp). He's at offer stage with Capco (consulting firm) \u2014 final round passed Jan 23, recruiter Gavin confirmed Bertie ap", "gist": null, "context": null, "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-27T12:03:37.851741", "question": "Terry is at offer stage with Capco (consulting firm) for Principal Consultant, AI Solution Lead role in Hong Kong.\n\n**Timeline:**\n- Jan 16: 2nd round interview (Subashini, Regional Lead Analytics & AI", "gist": null, "context": "job negotiation strategy", "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-27T19:40:23.765214", "question": "Terry is evaluating a Capco (consulting firm) offer in Hong Kong. He's concerned about the non-compete clause:\n\n**The clause (15.1):** 6 months post-employment, cannot work for:\n- Named competitors: A", "gist": null, "context": null, "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-30T16:06:22.366395", "question": "I'm leaving CNCBI (being counselled out, have Capco offer). Should I share my personal FAQ chatbot demo with Derek (Head of Direct Banking, worked together on agent-assist chatbot, potential Hang Seng", "gist": null, "context": null, "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}
-{"timestamp": "2026-01-31T08:10:37.823456", "question": "We've been building a system where:\n\n1. **Skills** = crystallized procedures (how to do things) - stored as SKILL.md files, invoked by Claude\n2. **Vault notes** = content libraries (what to know/say) ", "gist": null, "context": null, "rounds": 2, "blind": true, "models": ["Claude", "GPT", "Gemini", "Grok", "Kimi"]}