specfact-cli-modules

Central module registry for SpecFact CLI marketplace.

Repository scope

This repository hosts official nold-ai bundles only.

• Official bundles are maintained under packages/.
• Third-party bundles are published from third-party repositories and are not hosted here.
• Bundle and module documentation changes are made in this repository under docs/.
• GitHub Pages documentation target: https://nold-ai.github.io/specfact-cli-modules/.

Local development (IDE / Cursor)

Bundle packages import from specfact_cli (models, runtime, validators, etc.). Use Hatch so that this repo and your local specfact-cli checkout share one dev environment.

1. Create env:

hatch env create

2. Install specfact-cli editable dependency:

# prefers $SPECFACT_CLI_REPO, then a matching specfact-cli-worktrees branch, then ../specfact-cli
hatch run dev-deps

3. In Cursor/VS Code choose interpreter: specfact-cli-modules/.venv/bin/python

Quality gates

Run this sequence from repo root:

hatch run format
hatch run type-check
hatch run lint
hatch run yaml-lint
hatch run verify-modules-signature --require-signature --payload-from-filesystem --enforce-version-bump
hatch run contract-test
hatch run smart-test
hatch run test

To mirror CI locally with git hooks, enable pre-commit:

pre-commit install
pre-commit run --all-files

Scope notes:

• ruff runs on the full repo.
• basedpyright and pylint are scoped to src/, tests/, and tools/ for modules-repo infrastructure parity.
• Bundle-package behavioral validation is covered through test, contract-test, and migration-specific suite additions under tests/.
• test, smart-test, contract-test, lint, and type-check auto-install the matching local specfact-cli editable checkout when the active worktree venv is missing it.