flextools-mcp 2.3.1__py3-none-any.whl

flextools_mcp-2.3.1.dist-info/METADATA

@@ -0,0 +1,270 @@
+Metadata-Version: 2.4
+Name: flextools-mcp
+Version: 2.3.1
+Summary: MCP server that gives AI assistants searchable LibLCM / FlexLibs / Flexicon API docs for writing FLExTools scripts.
+Author-email: Matthew Lee <matthew_lee@sil.org>
+License: MIT License
+        
+        Copyright (c) 2025
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/MattGyverLee/FlexToolsMCP
+Project-URL: Repository, https://github.com/MattGyverLee/FlexToolsMCP
+Project-URL: Issues, https://github.com/MattGyverLee/FlexToolsMCP/issues
+Keywords: mcp,fieldworks,flextools,flexlibs,flexicon,liblcm,linguistics,lexicon
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Text Processing :: Linguistic
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.27.0
+Requires-Dist: anyio>=4.5
+Requires-Dist: httpx>=0.27.1
+Requires-Dist: typing-inspection>=0.4.1
+Requires-Dist: sentence-transformers>=2.2.0
+Requires-Dist: faiss-cpu>=1.7.4
+Requires-Dist: pythonnet>=3.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyflexicon>=4.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pre-commit>=4.0.0; extra == "dev"
+Dynamic: license-file
+
+# FLExTools MCP
+
+An MCP server that enables AI assistants to write FLExTools scripts and directly manipulate FieldWorks lexicon data using natural language.
+
+Developed for SIL Global by Matthew Lee in connection with the SIL's AI Integration Advisory Board and the FLExTrans team.
+
+## Quick Overview
+
+**What it does:** FLExTools MCP gives AI assistants (Claude, Copilot, Gemini) the knowledge to write FLExTools modules by providing indexed, searchable documentation of LibLCM and FlexLibs APIs.
+
+** Videos **
+
+## Videos
+
+**[The MCP Connection: Talking to your Dictinary](https://vimeo.com/showcase/12149678?video=1171396540)**
+
+This podcast, for a linguistic audience, gives an overview of using the FLExTools MCP.
+
+[![MCP Video Thumbnail](./docs/MCPodcast.png)](https://vimeo.com/showcase/12149678?video=1171396540)
+
+**[MCPs for FLEx and FLExTools: LangTech AI Software Engineering CoP](https://www.youtube.com/watch?v=JyNwUbAWYIM)**
+
+This presentation, given to an audience of programmers, discusses the background, architecture, and advantages of an MCP, and introduces the FLExTools MCP.
+
+[![COP Video Thumbnail](./docs/COP-Thumbnail.png)](https://www.youtube.com/watch?v=JyNwUbAWYIM)
+
+**Three ways to use it:**
+1. Generate legacy modules (FlexLibs stable)
+2. Generate modern modules (Flexicon with ~1,400 functions)
+3. Run operations directly on FieldWorks databases using natural language queries
+
+**Example:** "Delete any sense with 'q' in the gloss" → AI generates, tests, and runs the operation automatically.
+
+⚠️ **Warning:** Backup your project first - there are no guard-rails.
+
+## Why MCP? Why AI?
+
+- **What is an MCP Server?** See [WHY-MCP.md](docs/WHY-MCP.md) - explains the LibLCM complexity problem and why generic AI assistants fail
+- **When is AI useful?** See [WHY-AI.md](docs/WHY-AI.md) - learning curve problems and when manual approaches are better
+
+## Getting Started
+
+### 1. Installation
+
+FLExToolsMCP is published on PyPI. The indexed API documentation ships inside
+the package, so there is nothing to clone or build. The one prerequisite is
+FieldWorks/FLExTools, which means **Windows + .NET**.
+
+**One-line install (recommended)** — no repo, no manual dependency install:
+
+```bash
+# Claude Code
+claude mcp add flextoolsmcp -- uvx flextoolsmcp
+```
+
+`uvx` (from [uv](https://docs.astral.sh/uv/)) fetches the package and all of its
+dependencies — including [Flexicon](https://pypi.org/project/pyflexicon/), the
+deep FieldWorks wrapper — into an isolated cache and runs the server. Nothing
+else to install. Upgrading FLExToolsMCP re-resolves to the latest compatible
+Flexicon. Prefer a persistent install? `uv tool install flextoolsmcp` or
+`pip install flextoolsmcp`.
+
+**Manual MCP config** (Claude Desktop, Cursor, and other tools):
+
+```json
+{
+  "mcpServers": {
+    "flextoolsmcp": {
+      "command": "uvx",
+      "args": ["flextoolsmcp"]
+    }
+  }
+}
+```
+
+### 2. Connect to Your AI Assistant
+See [SETUP.md](SETUP.md#connecting-to-ai-assistants) for Claude Code, Antigravity, and other tools.
+
+**Note:** Each AI tool has different MCP configuration syntax. See SETUP.md for your specific tool.
+
+**User data** lives under `~/.flextoolsmcp/` (logs, saved skeletons, cached
+models, and any runtime-refreshed indexes) — it persists across upgrades.
+
+### Developing from source
+```bash
+git clone https://github.com/MattGyverLee/FlexToolsMCP.git
+cd FlexToolsMCP
+pip install -e ".[dev]"     # editable install with dev tools (pulls in Flexicon)
+
+# Test it works
+python -c "from flextoolsmcp.server import APIIndex, get_index_dir; i=APIIndex.load(get_index_dir()); print('Loaded', len(i.flexicon.get('entities', {})), 'Flexicon entities')"
+```
+
+### 3. Updating to New Versions
+See [SETUP.md](SETUP.md#updating-flextoolsmcp) for how to pull new releases.
+
+### 4. Start Using
+See [USAGE.md](USAGE.md) for workflows, tool reference, and examples.
+
+## What's Included
+
+### MCP Tools (16)
+
+**Admin & Config:**
+- `flextools_start` - Initialize session, set project and API mode
+- `flextools_manage_config` - Get/set/delete persistent configuration
+- `flextools_get_session_history` - View operation history and undo stack
+- `flextools_undo_last_operation` - Undo the most recent write
+- `flextools_get_module_template` - Get FLExTools module boilerplate
+
+**Discovery:**
+- `flextools_search_by_capability` - Find APIs by natural language intent
+- `flextools_get_object_api` - Get full API for an object/operations class
+- `flextools_get_navigation_path` - Find traversal between object types
+- `flextools_find_examples` - Get code examples by operation type
+- `flextools_resolve_property` - Check casting requirements for properties
+
+**Catalog:**
+- `flextools_list_categories` - List semantic domains (lexicon, grammar, etc.)
+- `flextools_list_entities_in_category` - List entities in a domain
+
+**Module & Execution:**
+- `flextools_start_module` - Interactive wizard for new module
+- `flextools_get_operation_logs` - View logs and pattern recommendations
+- `flextools_run_module` - Execute code with dry-run and write modes
+
+### API Coverage
+- **LibLCM**: 2,295 C# entities
+- **FlexLibs Stable**: ~71 methods
+- **Flexicon**: ~1,400 methods (99% documented, 82% with examples)
+
+### Test-Proven Examples
+```
+"Remove 'el ' from the beginning of any Spanish gloss"
+"Add an environment named 'pre-y' with the context '/_y'"
+"Delete the entry with lexeme ɛʃːɛr"
+"List entries with "ː" in the headword"
+"Are there any duplicates by gloss (fuzzy match) and POS?"
+```
+
+## Key Features
+
+- **Discovery-first workflow** - the AI assembles modules from indexed building blocks (signatures, navigation skeletons, examples, casting fixes) rather than inventing API calls from training memory. See [USAGE.md](USAGE.md#recommended-workflow).
+- **Automatic index refresh** when you update FieldWorks or libraries
+- **Dry-run mode** to test before writing data
+- **Semantic search** with synonym expansion
+- **Pythonnet casting detection** - warns when you need type conversions
+- **Code examples** extracted from real-world usage
+- **Multiple library versions** supported simultaneously
+
+## Documentation
+
+| Document | Purpose |
+|----------|---------|
+| [HISTORY.md](HISTORY.md) | Release notes and version history |
+| [SETUP.md](SETUP.md) | Installation and AI tool configuration |
+| [USAGE.md](USAGE.md) | How to use the MCP, workflows, examples |
+| [DEVELOPMENT.md](DEVELOPMENT.md) | Project structure, architecture, contributing |
+| [docs/WHY-MCP.md](docs/WHY-MCP.md) | Why FieldWorks needs MCP servers |
+| [docs/WHY-AI.md](docs/WHY-AI.md) | When AI is useful for FieldWorks work |
+| [docs/INNOVATIONS.md](docs/INNOVATIONS.md) | Technical innovations in this MCP |
+| [docs/BACKGROUND.md](docs/BACKGROUND.md) | Project history |
+
+## Safety & Limitations
+
+### Safety
+- **Always backup before write operations** - the MCP defaults to dry-run mode
+- Dry run shows what would happen before writing
+- Requires explicit user permission for write operations
+
+### Limitations
+- Cannot control the FLEx GUI (filters, display, etc.)
+- Only manipulates data, not UI state
+- Flexicon still undergoing extensive testing
+- Some Scripture module edge cases recently fixed
+
+## Architecture
+
+```
+User Request -> AI Assistant -> MCP Server -> Indexed APIs
+                    |
+            Generated FLExTools Script or Direct Execution
+                    |
+            FLExTools (IronPython) or Flexicon
+                    |
+            LibLCM (C# data model)
+                    |
+            FieldWorks Database
+```
+
+For technical details, see [DEVELOPMENT.md](DEVELOPMENT.md#architecture).
+
+## License
+
+MIT License - See LICENSE file for details
+
+## Contributing
+
+Contributions are welcome! Please submit issues and pull requests on GitHub.
+
+For development info, see [DEVELOPMENT.md](DEVELOPMENT.md).
+
+## Acknowledgments
+
+- The FieldWorks developers (Jason, Ken, Hasso, and team)
+- Craig, the developer of FLExTools and FlexLibs
+- The SIL AI Implementation Advisory Board
+- Ron, Beth and the FLExTrans team
+- My mentors Doug, Jeff, and Jenni at SIL LangTech

flextools_mcp-2.3.1.dist-info/RECORD

@@ -0,0 +1,62 @@
+flextools_mcp-2.3.1.dist-info/licenses/LICENSE,sha256=Btzdu2kIoMbdSp6OyCLupB1aRgpTCJ_szMimgEnpkkE,1056
+flextoolsmcp/__init__.py,sha256=XSbk7d57HjaxH8oPYBDNE3bNenH9G3jy7Z2xgLBXtCY,258
+flextoolsmcp/__main__.py,sha256=nKbGb0aOaPp7KdlOh7P6hgMQL8svGzx8iU83n34U7tI,179
+flextoolsmcp/archive_old_versions.py,sha256=QabentO9IOx1_BETERPybQtWmPH5UdfeOLVCUKXgwIk,4709
+flextoolsmcp/build_casting_index.py,sha256=65Q68P4RJQr7v4Ko-ttJB1wVHk1MC7-NUlX6Uf2qGYc,10713
+flextoolsmcp/build_embeddings.py,sha256=wman0UsOAgMuUJZs6pcNPYZM6lvX3HUZ-uZouKbB0yA,11409
+flextoolsmcp/build_navigation_graph.py,sha256=8H9q9glaYpsxL5u-aNEJcQtjvQJL8Cs0bMqMvwjGfUY,14062
+flextoolsmcp/build_reverse_mapping.py,sha256=StOgQVIUqWvKWY0ZbrRbKES7lhJMr24JynWyytRngUU,15437
+flextoolsmcp/casting_helpers.py,sha256=DMhzymrrkoE1NK6du6AqYKJ2SXt3VXZ2qV5eFYJMAy0,7104
+flextoolsmcp/config.py,sha256=MfFapEiCT75E1VrAzD6P4BjbQkIBG9wSoupg8GKIViQ,6014
+flextoolsmcp/constants.py,sha256=g1n208dYzeCBLjhY-q0XSw7YlcqPHOSznOjGIROjJ5k,5050
+flextoolsmcp/extract_patterns.py,sha256=lh7Wwxn68qrXRG5GdTAQVI715xKuu341xSIxSf5M4_o,9940
+flextoolsmcp/file_utils.py,sha256=addd38dzKfYHwxzQKXt27yJ36nR8s0HNc5U4nXL47w0,4539
+flextoolsmcp/flexicon_analyzer.py,sha256=HXhdWsrI_A2eAUojZvQFlS4J_ppprcLpohcF2zNBa1I,76281
+flextoolsmcp/json_utils.py,sha256=P0qiu5PVvuVLzROLzHJLxm0vpL4uULQfQ1_mXDdrlqo,2559
+flextoolsmcp/liblcm_extractor.py,sha256=PxpnwnkrHvtoo9JU2KMV1Z7UtC5T_oeMNz3HRyHpJR4,39831
+flextoolsmcp/refresh.py,sha256=wLga4aLycaYKRzPYsB_S04b9tH-PGWGe4bUrlcyp3Ss,19221
+flextoolsmcp/response_utils.py,sha256=06i2cpM8Y4Vev7DsIZ6CGrUKg5Wl3MZkAszwtlRVZpM,7205
+flextoolsmcp/server.py,sha256=rbiC83c2jymCxlF9kMx-RUZpxAYdQvRMErXPCO-bJ6E,34183
+flextoolsmcp/index/casting_index_liblcm-v11.0.0.json,sha256=XOyPBRx7Mr2SC9ZFPPhowiA_gdzpVDFzjg2yGoVtUHE,471212
+flextoolsmcp/index/common_patterns_flexicon-v4.1.0.json,sha256=unckiirNQGFWCklQ4MGrUrlr7u3MlKB9r-0SluJ_kQg,198280
+flextoolsmcp/index/navigation_graph_liblcm-v11.0.0.json,sha256=iJdsHu4GAHFKxGdA7W-AoL8kqDoObcfAvpoU4KAAZn0,648489
+flextoolsmcp/index/reverse_mapping_liblcm-v11.0.0.json,sha256=La0pZ4O5vZM0Tx-wcwYe5albNTIX0iYPA9QlJRTfbC4,192269
+flextoolsmcp/index/embeddings/embeddings.npy,sha256=bVxnTYpAV5uXTF_E6JBYeQyvoZw_O-QnvGr-gw_4lJ0,5479040
+flextoolsmcp/index/embeddings/faiss.index,sha256=s6spp5tydVqJbUmOtZhErVM28jykpMcR8LFZoR159Hk,5478957
+flextoolsmcp/index/embeddings/metadata.json,sha256=K5We7JnhPAfP72RUXX6v578HnUDYLBd920Ih4LZEiSY,2411141
+flextoolsmcp/index/flexlibs/flexicon_api_v4.1.0.json,sha256=SZaaRglzXsHblQ-IfBg-cpy70ON_uUvuG1gyyVwUd5E,3423399
+flextoolsmcp/index/flexlibs/flexicon_lcm_bridge_v4.1.0.json,sha256=kktYw9YjXQzrch60pIC1ZH1IVR7gWWPTQInpmSpXGh0,2273825
+flextoolsmcp/index/flexlibs/flexlibs_api_v1.2.8.json,sha256=QtUHCfFtmvFvHVzeMOWF-AF-UxZRTC5xj6Z7pOuSleg,92170
+flextoolsmcp/index/flexlibs/flexlibs_lcm_bridge_v1.2.8.json,sha256=S4ZbGqY1o93aBKJQs7lYcO9xZQfbSonVRsT3WTlxXw4,158397
+flextoolsmcp/index/liblcm/liblcm_api_v11.0.0.json,sha256=vE5RkscknYPByVAyi65UxcUHBTeAQn0XmFs5OFdv8uo,7899528
+flextoolsmcp/server/__init__.py,sha256=zKfat2VYygcNJ12-6wXFt0LfVWcJAc-bj1_-YaQrIY4,5024
+flextoolsmcp/server/constants.py,sha256=yZkMPnnLimgdlupcrZQvdzczMIoXJLy458nkIwP3CH8,3876
+flextoolsmcp/server/dispatch.py,sha256=K_H0zURsl4HW2vG-zIr_sE4OScaWSF5_RCVBGBTPPmA,10621
+flextoolsmcp/server/headless_report.py,sha256=3SWYAaNNJlAPL-ZI0XLEv_oB-Bs5BDk_YxoEewsOOlc,3250
+flextoolsmcp/server/kernel.py,sha256=QpynrsonQxgh5MNZw5s3cXflfes-en-mReMkJo2zGoE,25182
+flextoolsmcp/server/models.py,sha256=IR1-1iYNd1792io9hiO0qQZlH6VwVOd4j62FolOrp1c,16320
+flextoolsmcp/server/project_discovery.py,sha256=4yW6FrN7_YMhNewPTP8ZVik1312FvZDAGYTvFjIa3pk,10219
+flextoolsmcp/server/response_keys.py,sha256=l-JnNuY_gkspF7ReWCFj8AbH1diDVZaoIv-1lpfGZs8,10023
+flextoolsmcp/server/session.py,sha256=HEGTcKw0Me6_Le-8T-slkzEgRqumWHMTOT0G4Cq3eXM,20804
+flextoolsmcp/server/skeleton_storage.py,sha256=EdEeYMynyq1vgfWXcEnyewLEBLN2b6fOUo8-FRbY9_s,9651
+flextoolsmcp/server/subprocess_helpers.py,sha256=q4dJpzbeAsoP2l6mXmq-zLnVYgRExd7z86X9p30k9BU,2352
+flextoolsmcp/server/tool_definitions.py,sha256=h2m2HBEk5U5Nn6Ak7rclpyfpO8sDYsK3BwTP30r6XBk,17198
+flextoolsmcp/server/undo_subprocess.py,sha256=Xzbt0Dl1zoRK2joXCfjsK3U9ZzsndOBUaoDrtbnE5lg,6230
+flextoolsmcp/server/utils.py,sha256=RGOTuQ9k5E47EWk9sdeyUTTc1mr2TuOSG9nzVw2rMws,2200
+flextoolsmcp/server/validators.py,sha256=ie8xJZ_6vRvs5-bDmSfvgNSF1gxEYpTYVxsRwcYhgHY,106782
+flextoolsmcp/server/versioning.py,sha256=ICN7wf_zfVkP_RgKtsn4adXNlmpz2Wc-BD3ZYgIFwr0,11576
+flextoolsmcp/server/worked_examples.py,sha256=9bEuGwNPDC9TW3C00YDps1jNY98HDqVq9CxYkhbDzsg,15382
+flextoolsmcp/server/handlers/__init__.py,sha256=NYWIroAXv9kYSiqn-UC029UVIdRC-VYUbDE7bvyNLUs,1549
+flextoolsmcp/server/handlers/_import_helper.py,sha256=zyhvZ3anAE5gdX2FtPgPOfZ-UM5sI7llE8PX-iYPDKw,3118
+flextoolsmcp/server/handlers/admin.py,sha256=IFOq44Bipooo32wjczSM0c56Kz7tUzOkqaH_3v1sb2w,28778
+flextoolsmcp/server/handlers/api.py,sha256=CND39CcZeru_tF-q0zF4SKZMSy2HG30eUUIElf-QR8w,59123
+flextoolsmcp/server/handlers/catalog.py,sha256=2OWwIsjLm63cUdhep8jP2dcayHw-MTif_RSUzh89CMY,8950
+flextoolsmcp/server/handlers/discovery.py,sha256=tCUIBp_hW86xrZ8zrrfvASWfBVGEJanCWJ8z339Coe0,9450
+flextoolsmcp/server/handlers/equivalence.py,sha256=YBpWv132Y_8pqimtUZ-B6dvFmXkkha27D7FdNknO8L4,13740
+flextoolsmcp/server/handlers/execution.py,sha256=dIGFw0f63aPYs6DHHmdVyke-NDTMHViT2Q5C8-YUXG0,118384
+flextoolsmcp/server/handlers/utils.py,sha256=Wi8x6H7m6tTu0y6Uv7__mWKUZWXPPKz5TB5uc-uX5fs,662
+flextools_mcp-2.3.1.dist-info/METADATA,sha256=NuAJs8ET-LiTgJ5zC4ljJ_hCOZpelPfUxwAIm5PCBfY,10950
+flextools_mcp-2.3.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+flextools_mcp-2.3.1.dist-info/entry_points.txt,sha256=o2BDyBqeFAHv8AIs1S59VIgR2XK_SeDf-SNMye86bBw,97
+flextools_mcp-2.3.1.dist-info/top_level.txt,sha256=h0PkvfZ7L1s80bDim-ebiOLJHgKbMXNH2sAOharhmCM,13
+flextools_mcp-2.3.1.dist-info/RECORD,,

flextools_mcp-2.3.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

flextools_mcp-2.3.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+flextools-mcp = flextoolsmcp.server:run
+flextoolsmcp = flextoolsmcp.server:run

flextools_mcp-2.3.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+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.

flextools_mcp-2.3.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+flextoolsmcp

flextoolsmcp/__init__.py

@@ -0,0 +1,9 @@
+# FlexTools MCP Server
+try:
+    from importlib.metadata import version as _version
+
+    __version__ = _version("flextools-mcp")
+except Exception:  # pragma: no cover - source checkout without install
+    __version__ = "0.0.0.dev0"
+
+__all__ = ["__version__"]

flextoolsmcp/__main__.py

@@ -0,0 +1,9 @@
+"""Allow running the server via ``python -m flextoolsmcp``."""
+
+if __package__:
+    from .server import run
+else:
+    from server import run
+
+if __name__ == "__main__":
+    run()

flextoolsmcp/archive_old_versions.py

@@ -0,0 +1,159 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Archive Old API Versions
+
+Moves older versioned API files to archive subdirectories, keeping only
+the latest version of each API in the main index directory. Archived
+versions remain accessible to the build scripts.
+
+Usage:
+    python src/archive_old_versions.py
+    python src/archive_old_versions.py --keep 2  # Keep last 2 versions
+"""
+
+import argparse
+import re
+import shutil
+from pathlib import Path
+from typing import Dict, List, Tuple
+
+if __package__:
+    from .file_utils import get_index_dir
+else:
+    from file_utils import get_index_dir
+
+
+def parse_version(filename: str) -> Tuple[int, int, int]:
+    """Extract version tuple from filename like 'liblcm_api_v11.0.0.json'."""
+    match = re.search(r'v(\d+)\.(\d+)\.(\d+)', filename)
+    if match:
+        major, minor, patch = match.groups()
+        return (int(major), int(minor), int(patch))
+    return (0, 0, 0)
+
+
+def archive_versions_in_directory(
+    directory: Path,
+    pattern: str,
+    keep_count: int = 1
+) -> Dict[str, List[str]]:
+    """Archive old versions in a directory.
+
+    Args:
+        directory: Directory containing versioned files
+        pattern: Glob pattern like "liblcm_api_v*.json"
+        keep_count: Number of latest versions to keep in main directory
+
+    Returns:
+        Dict with 'archived' and 'kept' file lists
+    """
+    if not directory.exists():
+        return {"archived": [], "kept": []}
+
+    # Find all versioned files
+    files = sorted(directory.glob(pattern))
+    if len(files) <= keep_count:
+        return {"archived": [], "kept": [f.name for f in files]}
+
+    # Sort by version (descending, so latest first)
+    files_with_versions = [(f, parse_version(f.name)) for f in files]
+    files_with_versions.sort(key=lambda x: x[1], reverse=True)
+
+    # Keep latest N, archive the rest
+    keep_files = [f for f, _ in files_with_versions[:keep_count]]
+    archive_files = [f for f, _ in files_with_versions[keep_count:]]
+
+    # Create archive directory
+    archive_dir = directory / "archive"
+    archive_dir.mkdir(exist_ok=True)
+
+    # Move old files to archive
+    archived = []
+    for old_file in archive_files:
+        try:
+            archive_path = archive_dir / old_file.name
+            shutil.move(str(old_file), str(archive_path))
+            archived.append(old_file.name)
+            print(f"  [ARCHIVE] {old_file.name} -> archive/")
+        except FileNotFoundError:
+            # File already gone - skip it
+            pass
+
+    return {
+        "archived": archived,
+        "kept": [f.name for f in keep_files]
+    }
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Archive old API versions to subdirectories"
+    )
+    parser.add_argument(
+        "--keep",
+        type=int,
+        default=1,
+        help="Number of latest versions to keep in main directory (default: 1)"
+    )
+    parser.add_argument(
+        "--quiet",
+        action="store_true",
+        help="Suppress output"
+    )
+
+    args = parser.parse_args()
+
+    index_dir = get_index_dir()
+
+    print("[INFO] Archiving old API versions...")
+    print(f"  Keeping {args.keep} latest version(s)")
+
+    # Archive patterns by directory
+    # Note: patterns are defined only in their canonical locations to avoid duplication
+    patterns = {
+        index_dir / "liblcm": [
+            ("liblcm_api_v*.json", "LibLCM"),
+            ("casting_index_liblcm-v*.json", "Casting Index"),
+            ("navigation_graph_liblcm-v*.json", "Navigation Graph"),
+            ("reverse_mapping_liblcm-v*.json", "Reverse Mapping"),
+        ],
+        index_dir / "flexlibs": [
+            ("flexlibs_api_v*.json", "FlexLibs"),
+            ("flexicon_api_v*.json", "Flexicon"),
+            ("common_patterns_flexicon-v*.json", "Common Patterns"),
+        ],
+    }
+
+    total_archived = 0
+    total_kept = 0
+
+    for directory, file_patterns in patterns.items():
+        if not directory.exists():
+            continue
+
+        for pattern, label in file_patterns:
+            result = archive_versions_in_directory(
+                directory,
+                pattern,
+                keep_count=args.keep
+            )
+
+            archived_count = len(result["archived"])
+            kept_count = len(result["kept"])
+
+            if archived_count > 0:
+                print(f"[OK] {label}: Archived {archived_count}, Keeping {kept_count}")
+                total_archived += archived_count
+                total_kept += kept_count
+
+    if not args.quiet:
+        print(f"\n[DONE] Archived {total_archived} old versions")
+        if total_archived == 0:
+            print("  (No old versions to archive)")
+
+    return 0
+
+
+if __name__ == "__main__":
+    exit(main())