Repository navigation
Releases
v0.1.0-rc.1 — Demo repairs
Demo repair release candidate for the model-free ask-formly MCP.
Changes
- Executable help examples and scoped topic/fact discovery.
- Improved API-aware ranking, evidence selection, and access to existing related facts.
- One complete compact JSON text response, with shared provenance and a 30,000-byte serialized SDK result budget.
- Clearer caller repair instructions and recipe documentation.
Merged repairs: #22
Download and install
Download ask-formly-v0.1.0-rc.1-model-free.tar.gz and its .sha256 file below. GitHub's automatically generated source archives are not the installable runtime.
Requires Python 3.11+ with venv/pip and internet access to PyPI for the initial pinned dependency install. The exact archive was tested on macOS arm64 / Python 3.14.6; other combinations remain experimental.
From the download directory on macOS/Linux:
shasum -a 256 -c ask-formly-v0.1.0-rc.1-model-free.tar.gz.sha256
mkdir ask-formly-rc1-unpack
tar -xzf ask-formly-v0.1.0-rc.1-model-free.tar.gz -C ask-formly-rc1-unpack
python3 ask-formly-rc1-unpack/ask-formly-alpha/install.py --prefix /absolute/path/to/ask-formly-rc1Choose a new absolute installation directory. The extraction root remains ask-formly-alpha/. Use the generated mcp-config.json to update your local stdio MCP connection, then restart/reconnect it. Confirm help_formly, lookup_formly, discover_formly_candidates, and get_formly_facts appear.
Installation guide: https://github.com/dills122/ask-formly/blob/v0.1.0-rc.1/poc/contextual-kb/alpha/README.md
Verified scope and limits
- Source suite: 274 tests passed. Exact archive: clean install, dependency checks, doctor, MCP self-test, and six real stdio calls passed.
- Pinned Formly 6.3.12 core/Material, unchanged 192-fact / 36-document knowledge database. No models or hosted-provider calls from this runtime.
- Broader questions can still need discovery/fetch; some first-pass retrieval targets remain unmet. Issue #21 remains open. This release does not establish whole-library accuracy, browser qualification, or universal client/platform support.
- Full provisioned model-backed maintenance was not run in this worktree. A dependency forward-reference warning remains; tested startup and lookup passed.
Archive SHA-256: adce512cfe414c4982db0e3b0bc6fb53ae4120691419f49538594e20bbecb81e. Checksums are unsigned.
ask-formly v0.1.0-alpha.1 — model-free alpha
ask-formly v0.1.0-alpha.1
First model-free alpha prerelease. The calling agent owns question planning, relevance assessment and the final answer. The MCP supplies scoped Formly evidence with citations and performs no internal model/provider calls.
Included
- 192 facts in 36 documents, scoped exactly to Formly 6.3.12 core/Material.
- Model-free runtime, pinned Python dependencies, installer and generated stdio client configuration.
- File-integrity verification, doctor and a real MCP initialization/tool-catalog/read-only lookup self-test.
- Structured scope repair and bounded discovery/fetch recovery, including the qualified API fix for JSON Schema customization.
- Upstream Formly attribution notice.
Install
Download the archive and matching .sha256 from this release. From their directory:
shasum -a 256 -c ask-formly-0.1.0-alpha.1-model-free.tar.gz.sha256
mkdir ask-formly-unpack
tar -xzf ask-formly-0.1.0-alpha.1-model-free.tar.gz -C ask-formly-unpack
python3 ask-formly-unpack/ask-formly-alpha/install.py \
--prefix /absolute/path/to/ask-formly-alpha-installStop if checksum verification fails. Choose a new, absolute installation directory. Use the generated mcp-config.json command and arguments to create a local stdio MCP entry, then restart it. No model files or provider credentials are needed by the server. The installer downloads dependencies from PyPI.
Ask your agent: “Use ask-formly. For Formly 6.3.12 with Material, how can I hide a field without losing its model value? Explain whether its control stays registered.”
The included README has full setup, troubleshooting and rollback steps. The GitHub-generated source archives do not include the DB; use the explicitly named model-free asset for installation.
Tested scope and limitations
Tested on macOS arm64 with Python 3.14.6, using clean virtual environments on the existing test host and real calling-agent MCP checks. Other platforms, Python versions and Claude/Kiro harnesses remain unqualified. The installer accepts Python 3.11+, but this is not a compatibility guarantee.
This is library evidence, not application investigation or whole-library coverage. Unsupported versions/adapters stop rather than substitute scope. Candidate facts are not certified relevant; callers must assess conditions/limits and fetch complete citations. JSON Schema recovery was verified in two calls by an isolated agent; initial-packet relevance was not universally fixed.
Models and the installed development DB were not modified. No model weights, environments, raw request traces, private archives or sealed evaluation are included. The bundled DB is an exact copy of the pinned 192-fact knowledge artifact. Checksums are provided; this prerelease is not publisher-signed. Model-backed mode remains a separate development-checkout option and is not bundled.
Original ask-formly code is MIT-licensed. The archive includes the project license and the pinned upstream Formly MIT notice.