mindsystem-cc 3.17.1 → 3.18.1

package/scripts/scan-planning-context.py

@@ -343,6 +343,7 @@ def scan_debug_docs(
         results.append(
             {
                 "path": str(path),
+                "slug": path.stem,
                 "subsystem": fm.get("subsystem", ""),
                 "root_cause": fm.get("root_cause", ""),
                 "resolution": fm.get("resolution", ""),
@@ -552,6 +553,145 @@ def aggregate_from_summaries(
     }
 
 
+# ---------------------------------------------------------------------------
+# Markdown formatting
+# ---------------------------------------------------------------------------
+
+
+def format_markdown(output: dict[str, Any]) -> str:
+    """Format scanner output as readable markdown for LLM consumption."""
+    sections: list[str] = []
+    agg = output.get("aggregated", {})
+
+    # --- Established Patterns ---
+    patterns = agg.get("patterns_established", [])
+    if patterns:
+        lines = ["### Established Patterns"]
+        lines.extend(f"- {p}" for p in patterns)
+        sections.append("\n".join(lines))
+
+    # --- Tech Stack ---
+    tech = agg.get("tech_stack_added", [])
+    if tech:
+        sections.append(f"### Tech Stack\n{', '.join(tech)}")
+
+    # --- Key Decisions ---
+    decisions = agg.get("key_decisions", [])
+    if decisions:
+        lines = ["### Key Decisions"]
+        lines.extend(f"- {d}" for d in decisions)
+        sections.append("\n".join(lines))
+
+    # --- Key Files ---
+    created = agg.get("key_files_created", [])
+    modified = agg.get("key_files_modified", [])
+    if created or modified:
+        lines = ["### Key Files"]
+        if created:
+            lines.append("**Created:**")
+            lines.extend(f"- `{f}`" for f in created)
+        if modified:
+            lines.append("**Modified:**")
+            lines.extend(f"- `{f}`" for f in modified)
+        sections.append("\n".join(lines))
+
+    # --- Debug Learnings ---
+    debug = output.get("debug_learnings", [])
+    if debug:
+        lines = ["### Debug Learnings"]
+        for d in debug:
+            slug = d.get("slug", "unknown")
+            sub = d.get("subsystem", "")
+            rc = d.get("root_cause", "")
+            res = d.get("resolution", "")
+            lines.append(f"- **{slug}** ({sub}): {rc} — Fix: {res}")
+        sections.append("\n".join(lines))
+
+    # --- Adhoc Learnings ---
+    adhoc_entries = [
+        a for a in output.get("adhoc_learnings", []) if a.get("learnings")
+    ]
+    if adhoc_entries:
+        lines = ["### Adhoc Learnings"]
+        for a in adhoc_entries:
+            sub = a.get("subsystem", "")
+            path = a.get("path", "")
+            label = sub or Path(path).stem if path else "unknown"
+            lines.append(f"- **{label}**")
+            for learning in a["learnings"]:
+                lines.append(f"  - {learning}")
+        sections.append("\n".join(lines))
+
+    # --- Summaries ---
+    summaries = output.get("summaries", [])
+    needs_read = [
+        s
+        for s in summaries
+        if s.get("relevance") == "HIGH" and s.get("has_readiness_warnings")
+    ]
+    other_relevant = [
+        s
+        for s in summaries
+        if s.get("relevance") in ("HIGH", "MEDIUM")
+        and not s.get("has_readiness_warnings")
+    ]
+
+    if needs_read:
+        lines = ["### Summaries Needing Full Read"]
+        for s in needs_read:
+            lines.append(f"- `{s['path']}`")
+        sections.append("\n".join(lines))
+
+    if other_relevant:
+        lines = ["### Other Relevant Summaries"]
+        for s in other_relevant:
+            lines.append(f"- `{s['path']}` [{s.get('relevance', '')}]")
+        sections.append("\n".join(lines))
+
+    # --- Knowledge Files ---
+    matched_knowledge = [
+        k for k in output.get("knowledge_files", []) if k.get("matched")
+    ]
+    if matched_knowledge:
+        lines = ["### Knowledge Files to Read"]
+        for k in matched_knowledge:
+            lines.append(f"- `{k['path']}`")
+        sections.append("\n".join(lines))
+
+    # --- Pending Todos ---
+    todos = output.get("pending_todos", [])
+    if todos:
+        lines = ["### Pending Todos"]
+        for t in todos:
+            title = t.get("title", "untitled")
+            priority = t.get("priority", "")
+            sub = t.get("subsystem", "")
+            path = t.get("path", "")
+            lines.append(f"- **{title}** [{priority}] ({sub}) — `{path}`")
+        sections.append("\n".join(lines))
+
+    # --- Scanner Info ---
+    sources = output.get("sources", {})
+    parse_errors = sources.get("parse_errors", [])
+    info_lines = ["### Scanner Info"]
+    for name, src in sources.items():
+        if name == "parse_errors" or not isinstance(src, dict):
+            continue
+        scanned = src.get("scanned", 0)
+        skipped = src.get("skipped")
+        if skipped:
+            info_lines.append(f"- {name}: skipped ({skipped})")
+        else:
+            info_lines.append(f"- {name}: {scanned} scanned")
+    if parse_errors:
+        info_lines.append("**Parse errors:**")
+        for err in parse_errors:
+            info_lines.append(f"- `{err.get('path', '')}`: {err.get('error', '')}")
+    sections.append("\n".join(info_lines))
+
+    return "\n\n".join(sections)
+
+
 # ---------------------------------------------------------------------------
 # Main
 # ---------------------------------------------------------------------------
@@ -583,6 +723,11 @@ def build_parser() -> argparse.ArgumentParser:
         default="",
         help="Comma-separated keywords for tag matching",
     )
+    parser.add_argument(
+        "--json",
+        action="store_true",
+        help="Output raw JSON (default: formatted markdown)",
+    )
     return parser
 
 
@@ -604,40 +749,42 @@ def main() -> None:
 
     planning = find_planning_dir()
     if planning is None:
-        # No .planning/ directory — output valid JSON with all sources skipped
-        output: dict[str, Any] = {
-            "success": True,
-            "target": {
-                "phase": phase,
-                "phase_name": phase_name,
-                "subsystems": subsystems,
-                "keywords": keywords,
-            },
-            "sources": {
-                "summaries": {"dir": "", "scanned": 0, "skipped": ".planning/ not found"},
-                "debug_docs": {"dir": "", "scanned": 0, "skipped": ".planning/ not found"},
-                "adhoc_summaries": {"dir": "", "scanned": 0, "skipped": ".planning/ not found"},
-                "completed_todos": {"dir": "", "scanned": 0, "skipped": ".planning/ not found"},
-                "pending_todos": {"dir": "", "scanned": 0, "skipped": ".planning/ not found"},
-                "knowledge_files": {"dir": "", "scanned": 0, "skipped": ".planning/ not found"},
-                "parse_errors": [],
-            },
-            "summaries": [],
-            "debug_learnings": [],
-            "adhoc_learnings": [],
-            "completed_todos": [],
-            "pending_todos": [],
-            "knowledge_files": [],
-            "aggregated": {
-                "tech_stack_added": [],
-                "patterns_established": [],
-                "key_files_created": [],
-                "key_files_modified": [],
-                "key_decisions": [],
-            },
-        }
-        json.dump(output, sys.stdout, indent=2, cls=_SafeEncoder)
-        sys.stdout.write("\n")
+        if args.json:
+            output: dict[str, Any] = {
+                "success": True,
+                "target": {
+                    "phase": phase,
+                    "phase_name": phase_name,
+                    "subsystems": subsystems,
+                    "keywords": keywords,
+                },
+                "sources": {
+                    "summaries": {"dir": "", "scanned": 0, "skipped": ".planning/ not found"},
+                    "debug_docs": {"dir": "", "scanned": 0, "skipped": ".planning/ not found"},
+                    "adhoc_summaries": {"dir": "", "scanned": 0, "skipped": ".planning/ not found"},
+                    "completed_todos": {"dir": "", "scanned": 0, "skipped": ".planning/ not found"},
+                    "pending_todos": {"dir": "", "scanned": 0, "skipped": ".planning/ not found"},
+                    "knowledge_files": {"dir": "", "scanned": 0, "skipped": ".planning/ not found"},
+                    "parse_errors": [],
+                },
+                "summaries": [],
+                "debug_learnings": [],
+                "adhoc_learnings": [],
+                "completed_todos": [],
+                "pending_todos": [],
+                "knowledge_files": [],
+                "aggregated": {
+                    "tech_stack_added": [],
+                    "patterns_established": [],
+                    "key_files_created": [],
+                    "key_files_modified": [],
+                    "key_decisions": [],
+                },
+            }
+            json.dump(output, sys.stdout, indent=2, cls=_SafeEncoder)
+            sys.stdout.write("\n")
+        else:
+            print("No .planning/ directory found. No prior context available.")
         return
 
     parse_errors: list[dict[str, str]] = []
@@ -681,8 +828,11 @@ def main() -> None:
         "aggregated": aggregated,
     }
 
-    json.dump(output, sys.stdout, indent=2, cls=_SafeEncoder)
-    sys.stdout.write("\n")
+    if args.json:
+        json.dump(output, sys.stdout, indent=2, cls=_SafeEncoder)
+        sys.stdout.write("\n")
+    else:
+        print(format_markdown(output))
 
 
 if __name__ == "__main__":

package/scripts/validate-execution-order.sh

@@ -70,13 +70,13 @@ fi
 # --- Check 3 (warning): File conflicts within waves ---
 CURRENT_WAVE=""
 WAVE_COUNT=0
-declare -A WAVE_FILES
+CURRENT_WAVE_FILES=""
 
 while IFS= read -r line; do
   if echo "$line" | grep -qE '^## Wave [0-9]+'; then
     CURRENT_WAVE=$(echo "$line" | grep -oE '[0-9]+')
     WAVE_COUNT=$((WAVE_COUNT + 1))
-    WAVE_FILES[$CURRENT_WAVE]=""
+    CURRENT_WAVE_FILES=""
   elif [ -n "$CURRENT_WAVE" ]; then
     PLAN_FILE=$(echo "$line" | grep -oE '[0-9][0-9.]*-[0-9]+-PLAN\.md' || true)
     if [ -n "$PLAN_FILE" ] && [ -f "$PHASE_DIR/$PLAN_FILE" ]; then
@@ -84,11 +84,10 @@ while IFS= read -r line; do
       FILE_PATHS=$(grep -E '^\*\*Files:\*\*' "$PHASE_DIR/$PLAN_FILE" | sed 's/\*\*Files:\*\*//g' | tr ',' '\n' | sed 's/`//g; s/^[[:space:]]*//; s/[[:space:]]*$//' | grep -v '^$' || true)
       while IFS= read -r fpath; do
         [ -z "$fpath" ] && continue
-        EXISTING="${WAVE_FILES[$CURRENT_WAVE]}"
-        if echo "$EXISTING" | grep -qF "|$fpath|"; then
+        if echo "$CURRENT_WAVE_FILES" | grep -qF "|$fpath|"; then
           echo "WARNING: File '$fpath' appears in multiple plans within Wave $CURRENT_WAVE"
         else
-          WAVE_FILES[$CURRENT_WAVE]="${EXISTING}|$fpath|"
+          CURRENT_WAVE_FILES="${CURRENT_WAVE_FILES}|$fpath|"
         fi
       done <<< "$FILE_PATHS"
     fi

package/scripts/cleanup-phase-artifacts.sh

@@ -1,68 +0,0 @@
-#!/bin/bash
-#
-# cleanup-phase-artifacts.sh
-# Deletes raw phase artifacts (CONTEXT, DESIGN, RESEARCH, SUMMARY, UAT,
-# VERIFICATION, EXECUTION-ORDER) from all phases in a milestone range.
-# Knowledge files in .planning/knowledge/ are not touched.
-#
-# Usage: ./scripts/cleanup-phase-artifacts.sh <start_phase> <end_phase>
-# Example: ./scripts/cleanup-phase-artifacts.sh 1 6
-
-set -e
-
-# --- Validation ---
-if [ -z "$1" ] || [ -z "$2" ]; then
-  echo "Error: Two arguments required"
-  echo "Usage: $0 <start_phase> <end_phase>"
-  exit 1
-fi
-
-START="$1"
-END="$2"
-
-if ! [[ "$START" =~ ^[0-9]+$ ]] || ! [[ "$END" =~ ^[0-9]+$ ]]; then
-  echo "Error: Both arguments must be numeric"
-  echo "Usage: $0 <start_phase> <end_phase>"
-  exit 1
-fi
-
-if [ "$START" -gt "$END" ]; then
-  echo "Error: Start phase ($START) cannot exceed end phase ($END)"
-  exit 1
-fi
-
-# --- Find .planning from git root ---
-GIT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
-if [ -z "$GIT_ROOT" ]; then
-  echo "Error: Not in a git repository"
-  exit 1
-fi
-
-PHASES_DIR="$GIT_ROOT/.planning/phases"
-if [ ! -d "$PHASES_DIR" ]; then
-  echo "Error: Phases directory not found at $PHASES_DIR"
-  exit 1
-fi
-
-# --- Delete artifacts from each phase in range ---
-DELETED=0
-for dir in "$PHASES_DIR"/*/; do
-  [ -d "$dir" ] || continue
-  dirname=$(basename "$dir")
-  phase_num="${dirname%%-*}"
-  # Strip leading zeros for numeric comparison
-  phase_int=$((10#$phase_num))
-  if [ "$phase_int" -ge "$START" ] && [ "$phase_int" -le "$END" ]; then
-    for f in "$dir"/*-CONTEXT.md "$dir"/*-DESIGN.md "$dir"/*-RESEARCH.md \
-             "$dir"/*-SUMMARY.md "$dir"/*-UAT.md "$dir"/*-VERIFICATION.md \
-             "$dir"/*-EXECUTION-ORDER.md; do
-      if [ -f "$f" ]; then
-        rm -f "$f"
-        DELETED=$((DELETED + 1))
-      fi
-    done
-  fi
-done
-
-echo "Cleaned $DELETED artifact files from phases $START-$END"
-exit 0