@josephyan/qingflow-app-user-mcp 0.2.0-beta.46 → 0.2.0-beta.47

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @josephyan/qingflow-app-user-mcp@0.2.0-beta.46
+npm install @josephyan/qingflow-app-user-mcp@0.2.0-beta.47
 ```
 
 Run:
 
 ```bash
-npx -y -p @josephyan/qingflow-app-user-mcp@0.2.0-beta.46 qingflow-app-user-mcp
+npx -y -p @josephyan/qingflow-app-user-mcp@0.2.0-beta.47 qingflow-app-user-mcp
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josephyan/qingflow-app-user-mcp",
-  "version": "0.2.0-beta.46",
+  "version": "0.2.0-beta.47",
   "description": "Operational end-user MCP for Qingflow records, tasks, comments, and directory workflows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qingflow-mcp"
-version = "0.2.0b46"
+version = "0.2.0b47"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

package/src/qingflow_mcp/__init__.py

@@ -2,4 +2,4 @@ from __future__ import annotations
 
 __all__ = ["__version__"]
 
-__version__ = "0.2.0b46"
+__version__ = "0.2.0b47"

package/src/qingflow_mcp/tools/import_tools.py

@@ -1132,11 +1132,35 @@ def _analyze_headers(
     issues: list[JSONObject] = []
     repair_suggestions: list[str] = []
     if missing:
-        issues.append(_issue("MISSING_COLUMNS", f"Missing expected columns: {', '.join(missing)}", severity="error"))
+        issues.append(
+            _issue(
+                "MISSING_COLUMNS",
+                f"Missing expected columns: {', '.join(missing)}",
+                severity="error",
+                repairable=True,
+                repair_code="normalize_headers",
+            )
+        )
     if extra:
-        issues.append(_issue("EXTRA_COLUMNS", f"Unexpected columns: {', '.join(extra)}", severity="error"))
+        issues.append(
+            _issue(
+                "EXTRA_COLUMNS",
+                f"Unexpected columns: {', '.join(extra)}",
+                severity="error",
+                repairable=True,
+                repair_code="normalize_headers",
+            )
+        )
     if duplicates:
-        issues.append(_issue("DUPLICATE_COLUMNS", f"Duplicate columns: {', '.join(sorted(set(duplicates)))}", severity="error"))
+        issues.append(
+            _issue(
+                "DUPLICATE_COLUMNS",
+                f"Duplicate columns: {', '.join(sorted(set(duplicates)))}",
+                severity="error",
+                repairable=True,
+                repair_code="normalize_headers",
+            )
+        )
     normalized_changes = []
     for text in actual_headers:
         if not text:
@@ -1144,7 +1168,7 @@ def _analyze_headers(
         canonical = allowed_by_key.get(_normalize_header_key(text))
         if canonical and canonical != text:
             normalized_changes.append((text, canonical))
-    if normalized_changes:
+    if missing or extra or duplicates or normalized_changes:
         repair_suggestions.append("normalize_headers")
     return {"issues": issues, "repair_suggestions": repair_suggestions}
 
@@ -1194,7 +1218,8 @@ def _sheet_header_map(sheet) -> dict[str, int]:  # type: ignore[no-untyped-def]
 def _repair_headers(sheet, expected_columns: list[JSONObject]) -> bool:  # type: ignore[no-untyped-def]
     changed = False
     expected_by_key = {_normalize_header_key(item["title"]): item["title"] for item in expected_columns}
-    for cell in next(sheet.iter_rows(min_row=1, max_row=1), []):
+    header_cells = list(next(sheet.iter_rows(min_row=1, max_row=1), []))
+    for cell in header_cells:
         text = _normalize_optional_text(cell.value)
         if text is None:
             continue
@@ -1202,6 +1227,19 @@ def _repair_headers(sheet, expected_columns: list[JSONObject]) -> bool:  # type:
         if canonical and canonical != text:
             cell.value = canonical
             changed = True
+    if changed:
+        return True
+
+    # Fallback for template-based files where headers were edited into non-canonical
+    # values but column order is still intact. Keep any extra trailing system columns.
+    for index, column in enumerate(expected_columns, start=1):
+        if index > len(header_cells):
+            break
+        expected_title = str(column["title"]).strip()
+        current_title = _normalize_optional_text(header_cells[index - 1].value)
+        if current_title != expected_title:
+            header_cells[index - 1].value = expected_title
+            changed = True
     return changed