@hustle-together/api-dev-tools 1.8.0 → 2.0.0

package/hooks/enforce-interview.py

@@ -259,11 +259,61 @@ Reset the interview and ask with options based on research."""
             }))
             sys.exit(0)
 
-    # All checks passed
-    print(json.dumps({"permissionDecision": "allow"}))
+    # All checks passed - inject interview decisions as context reminder
+    decisions = interview.get("decisions", {})
+
+    if decisions:
+        # Build a reminder of what the user decided
+        decision_summary = _build_decision_summary(decisions)
+
+        # Allow but inject context about user decisions
+        print(json.dumps({
+            "permissionDecision": "allow",
+            "message": f"""✅ Interview complete. REMEMBER THE USER'S DECISIONS:
+
+{decision_summary}
+
+Your implementation MUST align with these choices.
+The state file tracks these for consistency verification."""
+        }))
+    else:
+        print(json.dumps({"permissionDecision": "allow"}))
+
     sys.exit(0)
 
 
+def _build_decision_summary(decisions: dict) -> str:
+    """Build a human-readable summary of user decisions from the interview."""
+    if not decisions:
+        return "No key decisions recorded."
+
+    lines = []
+    decision_labels = {
+        "provider": "AI Provider",
+        "purpose": "Primary Purpose",
+        "response_format": "Response Format",
+        "required_params": "Required Parameters",
+        "optional_params": "Optional Parameters",
+        "error_handling": "Error Handling",
+        "api_key_handling": "API Key Handling",
+        "external_services": "External Services",
+    }
+
+    for key, data in decisions.items():
+        label = decision_labels.get(key, key.replace("_", " ").title())
+        response = data.get("response", "")
+        value = data.get("value", "")
+
+        if value:
+            lines.append(f"• {label}: {value}")
+        elif response:
+            # Truncate long responses
+            short_response = response[:80] + "..." if len(response) > 80 else response
+            lines.append(f"• {label}: {short_response}")
+
+    return "\n".join(lines) if lines else "No key decisions recorded."
+
+
 def _build_research_based_example(research_queries: list) -> str:
     """Build an example question based on actual research queries."""
     if not research_queries:

package/hooks/track-tool-use.py

@@ -61,7 +61,8 @@ def main():
             "status": "not_started",
             "questions": [],
             "user_question_count": 0,
-            "structured_question_count": 0
+            "structured_question_count": 0,
+            "decisions": {}  # Track key decisions for consistency checking
         })
 
         # Track the question
@@ -78,16 +79,62 @@ def main():
             structured_count = interview.get("structured_question_count", 0) + 1
             interview["structured_question_count"] = structured_count
 
+        # IMPORTANT: Capture the user's response from tool_output
+        # PostToolUse runs AFTER the tool completes, so we have the response
+        user_response = None
+        selected_value = None
+
+        # tool_output contains the user's response
+        if isinstance(tool_output, str):
+            user_response = tool_output
+        elif isinstance(tool_output, dict):
+            user_response = tool_output.get("response", tool_output.get("result", str(tool_output)))
+
+        # Try to match response to an option value
+        if has_options and user_response:
+            response_lower = user_response.lower().strip()
+            for opt in options:
+                opt_value = opt.get("value", "").lower()
+                opt_label = opt.get("label", "").lower()
+                # Check if response matches value or label
+                if opt_value in response_lower or response_lower in opt_label or opt_label in response_lower:
+                    selected_value = opt.get("value")
+                    break
+
         question_entry = {
             "question": tool_input.get("question", ""),
             "timestamp": datetime.now().isoformat(),
             "tool_used": True,  # Proves AskUserQuestion was actually called
             "has_options": has_options,
             "options_count": len(options),
-            "options": [opt.get("label", opt.get("value", "")) for opt in options[:5]] if options else []
+            "options": [opt.get("label", opt.get("value", "")) for opt in options[:5]] if options else [],
+            "user_response": user_response[:500] if user_response else None,  # Capture actual response
+            "selected_value": selected_value  # Matched option value if applicable
         }
         questions.append(question_entry)
 
+        # Track key decisions in a summary dict for easy reference during implementation
+        decisions = interview.setdefault("decisions", {})
+        question_text = tool_input.get("question", "").lower()
+
+        # Categorize common decision types
+        if "provider" in question_text or "ai provider" in question_text:
+            decisions["provider"] = {"response": user_response, "value": selected_value}
+        elif "purpose" in question_text or "primary purpose" in question_text:
+            decisions["purpose"] = {"response": user_response, "value": selected_value}
+        elif "format" in question_text or "response format" in question_text:
+            decisions["response_format"] = {"response": user_response, "value": selected_value}
+        elif "parameter" in question_text and "required" in question_text:
+            decisions["required_params"] = {"response": user_response, "value": selected_value}
+        elif "parameter" in question_text and "optional" in question_text:
+            decisions["optional_params"] = {"response": user_response, "value": selected_value}
+        elif "error" in question_text:
+            decisions["error_handling"] = {"response": user_response, "value": selected_value}
+        elif "api key" in question_text or "key" in question_text:
+            decisions["api_key_handling"] = {"response": user_response, "value": selected_value}
+        elif "service" in question_text or "external" in question_text:
+            decisions["external_services"] = {"response": user_response, "value": selected_value}
+
         # Update interview status
         if interview.get("status") == "not_started":
             interview["status"] = "in_progress"
@@ -100,6 +147,8 @@ def main():
             interview["last_structured_question"] = {
                 "question": tool_input.get("question", "")[:100],
                 "options_count": len(options),
+                "user_response": user_response[:100] if user_response else None,
+                "selected_value": selected_value,
                 "timestamp": datetime.now().isoformat()
             }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hustle-together/api-dev-tools",
-  "version": "1.8.0",
+  "version": "2.0.0",
   "description": "Interview-driven API development workflow for Claude Code - Automates research, testing, and documentation",
   "main": "bin/cli.js",
   "bin": {