MCP/mcp-office-tools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add behind-the-scenes link to discernment blog post
Some checks are pending
Test Dashboard / test-and-dashboard (push) Waiting to run
Details

Browse Source 
Links README to Ryan's AI discernment article, which discusses
the documentation rewrite process and connects to the model's
perspective in the collaborations archive.
This commit is contained in:
Ryan Malloy 2026-01-11 02:02:34 -07:00
parent f159efab2c
commit 35869b6099
6 changed files with 24 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
README.md
View File

@ -360,6 +360,12 @@ uv run mypy src/
- **[MCP PDF Tools](https://github.com/yourusername/mcp-pdf-tools)** - Companion server for PDF processing - **[MCP PDF Tools](https://github.com/yourusername/mcp-pdf-tools)** - Companion server for PDF processing
- **[FastMCP](https://gofastmcp.com)** - The framework powering this server - **[FastMCP](https://gofastmcp.com)** - The framework powering this server
## 📝 Behind the Scenes
This README was rewritten during a human-AI collaboration session. The process raised questions about discernment, voice, and what makes documentation actually land:
- **[AI Isn't New. Your Discernment Is What Matters.](https://ryanmalloy.com/blog/ai-discernment)** — Ryan's take on 40 years of writing code and why discernment matters more than the tools
--- ---
## 📜 License ## 📜 License

6
reports/pytest_results.json
View File

@ -1,9 +1,9 @@
{ {
"metadata": { "metadata": {
"start_time": "2026-01-11T00:23:10.209539", "start_time": "2026-01-11T00:28:31.202459",
"pytest_version": "9.0.2", "pytest_version": "9.0.2",
"end_time": "2026-01-11T00:23:10.999816", "end_time": "2026-01-11T00:28:32.132845",
"duration": 0.7902717590332031, "duration": 0.9303832054138184,
"exit_status": 0 "exit_status": 0
}, },
"summary": { "summary": {

2
reports/test_dashboard.html
View File

@ -958,6 +958,6 @@
new TestDashboard(); new TestDashboard();
} }
</script> </script>
<script type="application/json" id="test-results-data">{"metadata": {"start_time": "2026-01-11T00:23:10.209539", "end_time": "2026-01-11T00:23:12.295169", "duration": 1.052842140197754, "exit_status": 0, "pytest_version": "9.0.2", "test_types": ["pytest", "torture_test"]}, "summary": {"total": 6, "passed": 5, "failed": 0, "skipped": 1, "pass_rate": 83.33333333333334}, "categories": {"Excel": {"total": 4, "passed": 3, "failed": 0, "skipped": 1}, "Word": {"total": 2, "passed": 2, "failed": 0, "skipped": 0}}, "tests": [{"name": "Excel Data Analysis", "nodeid": "torture_test.py::test_excel_data_analysis", "category": "Excel", "outcome": "passed", "duration": 0.1404409408569336, "timestamp": "2026-01-11T00:23:12.271793", "module": "torture_test", "class": null, "function": "test_excel_data_analysis", "inputs": {"file": "test_files/test_data.xlsx"}, "outputs": {"sheets_analyzed": ["Test Data"]}, "error": null, "traceback": null}, {"name": "Excel Formula Extraction", "nodeid": "torture_test.py::test_excel_formula_extraction", "category": "Excel", "outcome": "passed", "duration": 0.0031723976135253906, "timestamp": "2026-01-11T00:23:12.274971", "module": "torture_test", "class": null, "function": "test_excel_formula_extraction", "inputs": {"file": "test_files/test_data.xlsx"}, "outputs": {"total_formulas": 8}, "error": null, "traceback": null}, {"name": "Excel Chart Data Generation", "nodeid": "torture_test.py::test_excel_chart_generation", "category": "Excel", "outcome": "passed", "duration": 0.003323078155517578, "timestamp": "2026-01-11T00:23:12.278299", "module": "torture_test", "class": null, "function": "test_excel_chart_generation", "inputs": {"file": "test_files/test_data.xlsx", "x_column": "Category", "y_columns": ["Value"]}, "outputs": {"chart_libraries": 2}, "error": null, "traceback": null}, {"name": "Word Structure Analysis", "nodeid": "torture_test.py::test_word_structure_analysis", "category": "Word", "outcome": "passed", "duration": 0.010413646697998047, "timestamp": "2026-01-11T00:23:12.288718", "module": "torture_test", "class": null, "function": "test_word_structure_analysis", "inputs": {"file": "test_files/test_document.docx"}, "outputs": {"total_headings": 0}, "error": null, "traceback": null}, {"name": "Word Table Extraction", "nodeid": "torture_test.py::test_word_table_extraction", "category": "Word", "outcome": "passed", "duration": 0.006224393844604492, "timestamp": "2026-01-11T00:23:12.294948", "module": "torture_test", "class": null, "function": "test_word_table_extraction", "inputs": {"file": "test_files/test_document.docx"}, "outputs": {"total_tables": 0}, "error": null, "traceback": null}, {"name": "Real Excel File Analysis (FORScan)", "nodeid": "torture_test.py::test_real_excel_analysis", "category": "Excel", "outcome": "skipped", "duration": 0, "timestamp": "2026-01-11T00:23:12.294963", "module": "torture_test", "class": null, "function": "test_real_excel_analysis", "inputs": {"file": "/home/rpm/FORScan Lite spreadsheets v1.1/FORScan Lite spreadsheet - PIDs.xlsx"}, "outputs": null, "error": "File not found: /home/rpm/FORScan Lite spreadsheets v1.1/FORScan Lite spreadsheet - PIDs.xlsx", "traceback": null}]}</script> <script type="application/json" id="test-results-data">{"metadata": {"start_time": "2026-01-11T00:28:31.202459", "end_time": "2026-01-11T00:28:33.718606", "duration": 1.2442383766174316, "exit_status": 0, "pytest_version": "9.0.2", "test_types": ["pytest", "torture_test"]}, "summary": {"total": 6, "passed": 5, "failed": 0, "skipped": 1, "pass_rate": 83.33333333333334}, "categories": {"Excel": {"total": 4, "passed": 3, "failed": 0, "skipped": 1}, "Word": {"total": 2, "passed": 2, "failed": 0, "skipped": 0}}, "tests": [{"name": "Excel Data Analysis", "nodeid": "torture_test.py::test_excel_data_analysis", "category": "Excel", "outcome": "passed", "duration": 0.17873024940490723, "timestamp": "2026-01-11T00:28:33.696485", "module": "torture_test", "class": null, "function": "test_excel_data_analysis", "inputs": {"file": "test_files/test_data.xlsx"}, "outputs": {"sheets_analyzed": ["Test Data"]}, "error": null, "traceback": null}, {"name": "Excel Formula Extraction", "nodeid": "torture_test.py::test_excel_formula_extraction", "category": "Excel", "outcome": "passed", "duration": 0.0032067298889160156, "timestamp": "2026-01-11T00:28:33.699697", "module": "torture_test", "class": null, "function": "test_excel_formula_extraction", "inputs": {"file": "test_files/test_data.xlsx"}, "outputs": {"total_formulas": 8}, "error": null, "traceback": null}, {"name": "Excel Chart Data Generation", "nodeid": "torture_test.py::test_excel_chart_generation", "category": "Excel", "outcome": "passed", "duration": 0.0025446414947509766, "timestamp": "2026-01-11T00:28:33.702246", "module": "torture_test", "class": null, "function": "test_excel_chart_generation", "inputs": {"file": "test_files/test_data.xlsx", "x_column": "Category", "y_columns": ["Value"]}, "outputs": {"chart_libraries": 2}, "error": null, "traceback": null}, {"name": "Word Structure Analysis", "nodeid": "torture_test.py::test_word_structure_analysis", "category": "Word", "outcome": "passed", "duration": 0.010314226150512695, "timestamp": "2026-01-11T00:28:33.712565", "module": "torture_test", "class": null, "function": "test_word_structure_analysis", "inputs": {"file": "test_files/test_document.docx"}, "outputs": {"total_headings": 0}, "error": null, "traceback": null}, {"name": "Word Table Extraction", "nodeid": "torture_test.py::test_word_table_extraction", "category": "Word", "outcome": "passed", "duration": 0.005824089050292969, "timestamp": "2026-01-11T00:28:33.718393", "module": "torture_test", "class": null, "function": "test_word_table_extraction", "inputs": {"file": "test_files/test_document.docx"}, "outputs": {"total_tables": 0}, "error": null, "traceback": null}, {"name": "Real Excel File Analysis (FORScan)", "nodeid": "torture_test.py::test_real_excel_analysis", "category": "Excel", "outcome": "skipped", "duration": 0, "timestamp": "2026-01-11T00:28:33.718405", "module": "torture_test", "class": null, "function": "test_real_excel_analysis", "inputs": {"file": "/home/rpm/FORScan Lite spreadsheets v1.1/FORScan Lite spreadsheet - PIDs.xlsx"}, "outputs": null, "error": "File not found: /home/rpm/FORScan Lite spreadsheets v1.1/FORScan Lite spreadsheet - PIDs.xlsx", "traceback": null}]}</script>
</body> </body>
</html> </html>

BIN
reports/test_files/test_data.xlsx
View File

Binary file not shown.

BIN
reports/test_files/test_document.docx
View File

Binary file not shown.

28
reports/test_results.json
View File

@ -1,8 +1,8 @@
{ {
"metadata": { "metadata": {
"start_time": "2026-01-11T00:23:10.209539", "start_time": "2026-01-11T00:28:31.202459",
"end_time": "2026-01-11T00:23:12.295169", "end_time": "2026-01-11T00:28:33.718606",
"duration": 1.052842140197754, "duration": 1.2442383766174316,
"exit_status": 0, "exit_status": 0,
"pytest_version": "9.0.2", "pytest_version": "9.0.2",
"test_types": [ "test_types": [
@ -37,8 +37,8 @@
"nodeid": "torture_test.py::test_excel_data_analysis", "nodeid": "torture_test.py::test_excel_data_analysis",
"category": "Excel", "category": "Excel",
"outcome": "passed", "outcome": "passed",
"duration": 0.1404409408569336, "duration": 0.17873024940490723,
"timestamp": "2026-01-11T00:23:12.271793", "timestamp": "2026-01-11T00:28:33.696485",
"module": "torture_test", "module": "torture_test",
"class": null, "class": null,
"function": "test_excel_data_analysis", "function": "test_excel_data_analysis",
@ -58,8 +58,8 @@
"nodeid": "torture_test.py::test_excel_formula_extraction", "nodeid": "torture_test.py::test_excel_formula_extraction",
"category": "Excel", "category": "Excel",
"outcome": "passed", "outcome": "passed",
"duration": 0.0031723976135253906, "duration": 0.0032067298889160156,
"timestamp": "2026-01-11T00:23:12.274971", "timestamp": "2026-01-11T00:28:33.699697",
"module": "torture_test", "module": "torture_test",
"class": null, "class": null,
"function": "test_excel_formula_extraction", "function": "test_excel_formula_extraction",
@ -77,8 +77,8 @@
"nodeid": "torture_test.py::test_excel_chart_generation", "nodeid": "torture_test.py::test_excel_chart_generation",
"category": "Excel", "category": "Excel",
"outcome": "passed", "outcome": "passed",
"duration": 0.003323078155517578, "duration": 0.0025446414947509766,
"timestamp": "2026-01-11T00:23:12.278299", "timestamp": "2026-01-11T00:28:33.702246",
"module": "torture_test", "module": "torture_test",
"class": null, "class": null,
"function": "test_excel_chart_generation", "function": "test_excel_chart_generation",
@ -100,8 +100,8 @@
"nodeid": "torture_test.py::test_word_structure_analysis", "nodeid": "torture_test.py::test_word_structure_analysis",
"category": "Word", "category": "Word",
"outcome": "passed", "outcome": "passed",
"duration": 0.010413646697998047, "duration": 0.010314226150512695,
"timestamp": "2026-01-11T00:23:12.288718", "timestamp": "2026-01-11T00:28:33.712565",
"module": "torture_test", "module": "torture_test",
"class": null, "class": null,
"function": "test_word_structure_analysis", "function": "test_word_structure_analysis",
@ -119,8 +119,8 @@
"nodeid": "torture_test.py::test_word_table_extraction", "nodeid": "torture_test.py::test_word_table_extraction",
"category": "Word", "category": "Word",
"outcome": "passed", "outcome": "passed",
"duration": 0.006224393844604492, "duration": 0.005824089050292969,
"timestamp": "2026-01-11T00:23:12.294948", "timestamp": "2026-01-11T00:28:33.718393",
"module": "torture_test", "module": "torture_test",
"class": null, "class": null,
"function": "test_word_table_extraction", "function": "test_word_table_extraction",
@ -139,7 +139,7 @@
"category": "Excel", "category": "Excel",
"outcome": "skipped", "outcome": "skipped",
"duration": 0, "duration": 0,
"timestamp": "2026-01-11T00:23:12.294963", "timestamp": "2026-01-11T00:28:33.718405",
"module": "torture_test", "module": "torture_test",
"class": null, "class": null,
"function": "test_real_excel_analysis", "function": "test_real_excel_analysis",