night-market-operations

Run and ship this repo: make targets, artifacts, release runbook. Use when testing, linting, or releasing. Do not use for setup; use night-market-build-and-env.

Jump to install

Repository: athola/claude-night-market
Last source activity: July 3, 2026 at 17:10
Detected SKILL.md language: English
Stars: 327
Forks: 35

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Back to search Back to installation

name	night-market-operations
description	Run and ship this repo: make targets, artifacts, release runbook. Use when testing, linting, or releasing. Do not use for setup; use night-market-build-and-env.

Night Market Operations

This skill is the runbook for operating the claude-night-market repo: what each make target actually executes, where artifacts land, and the exact sequence that ships a release. Every command below was verified against the Makefile, scripts/, and .github/workflows/ on 2026-07-02 (repo v1.9.15).

Terms used once and reused throughout:

Plugin: a directory under plugins/ with a .claude-plugin/plugin.json manifest. Most have their own Makefile, pyproject.toml, and tests/.
skrills: a Rust CLI for skill validation and token analysis, vendored at plugins/abstract/bin/skrills. Every skrills target has a Python fallback, so a missing binary never blocks you.
ClawHub export: a cross-framework skill package format written to clawhub/ by scripts/clawhub_export.py.

All commands run from the repo root unless a cd is shown. uv is required for everything Python. For environment setup, see night-market-build-and-env.

Command anatomy

Command	What it actually executes	When to use	Expected output shape
`make test`	`./scripts/run-plugin-tests.sh --all`: per plugin, runs `make test --quiet` if the plugin Makefile has a `test:` target, else `uv run python -m pytest tests/ --tb=short --quiet` if pyproject mentions pytest. Skips plugins without .

tests/

make sanctum-test        # run sanctum's test suite
make imbue-lint          # run imbue's lint target
make abstract-help       # list a plugin's own targets

cd plugins/imbue && uv run pytest tests/unit/test_deferred_capture.py -x -q

Artifact	Producer	Location	Committed?
`htmlcov/`, `coverage.xml`	pytest coverage addopts	Repo root and per-plugin dirs	Present in tree but regenerated. Never hand-edit
`reports/skill-graph.json`	skill-graph tooling	`reports/`	No, generated locally (`reports/` is gitignored). Rebuild with the skill-graph tooling
`clawhub/`	`make clawhub-export`	`clawhub/manifest.json` plus one `nm-<plugin>-<skill>/` dir per exported skill	No, generated locally. `make clawhub-export` rebuilds it, and the release workflow regenerates it in CI
`bridge/openclaw/`, `bridge/a2a/`	`make bridge-build`, `make a2a-cards`	`bridge/`	Build outputs. `make bridge-clean` removes skills and a2a
`book/build/`	`mdbook build` (book/book.toml sets `build-dir = "build"`)	`book/build/`	No, CI-built
`trust-report.json`	CI only: trust-attestation.yml on push to master	Workflow workspace, SLSA-attested	No, never in tree

Preflight. Run Skill(sanctum:git-workspace-review) (read-only workspace check). Confirm you are on a <topic>-<version> branch, not master.
Bump the version everywhere. Dry-run first:
```
uv run python plugins/sanctum/scripts/update_versions.py 1.9.16 --dry-run
uv run python plugins/sanctum/scripts/update_versions.py 1.9.16
git diff --stat
```
The script rejects anything not matching ^\d+\.\d+\.\d+$, then rewrites the version field in every match of these globs (cache and venv dirs excluded): **/pyproject.toml, **/Cargo.toml, **/package.json, **/.claude-plugin/plugin.json, **/.claude-plugin/metadata.json, **/.claude-plugin/marketplace.json, **/openpackage.yml, and any **/__init__.py containing __version__. Expect a large diff of roughly 100 files. That is the design.
CHANGELOG entry. CHANGELOG.md follows Keep a Changelog 1.1.0 with SemVer. Keep ## [Unreleased] at the top and insert ## [X.Y.Z] - YYYY-MM-DD directly below it. Never rewrite or de-slop historical entries.
Docs sync. Update the per-plugin version column in docs/api-overview.md. Then:
```
make docs-sync-check
```
If it reports drift between plugin.json registrations and the capabilities reference (book/src/reference/, generated content), run /sanctum:sync-capabilities --fix.
PR and gates. Open the PR and clear the gates per night-market-change-control (pre-commit hooks, slop-check on docs, capabilities-sync, typecheck, security workflows).
Merge to master. trust-attestation.yml fires on the push: it runs make test, writes trust-report.json, and attaches a SLSA provenance attestation via actions/attest-build-provenance@v4.
Tag. Run /sanctum:create-tag v1.9.16. It pushes a v-prefixed annotated tag and confirms the release pipeline started.
Release pipeline. cross-framework-publish.yml fires on v* tags: it strips the v, validates the version against ^[0-9]+\.[0-9]+\.[0-9]+, runs the cross-framework unit tests (clawhub_export, build_bridge, a2a_cards, framework_detect), runs make cross-framework, packages four tarballs (night-market-clawhub, night-market-openclaw-bridge, night-market-a2a-cards, night-market-cross-framework), and creates the GitHub release. Precondition: the publish job fails if clawhub/manifest.json is missing or its total_exported is 0 (currently 188). Post-release ClawHub submission is manual: ./scripts/clawhub-submit.sh v<version>.

cd book && mdbook build   # output in book/build/

make clawhub-export       # export all skills to clawhub/, then validate
make clawhub-export-top   # top 20 most marketable skills only
make clawhub-validate     # re-validate an existing export
make clawhub-stats        # export statistics, no writes
make bridge-build         # (depends on clawhub-export) build bridge/openclaw/
make a2a-cards            # generate A2A agent cards into bridge/a2a/
make a2a-list             # list agents eligible for card generation
make detect-framework     # detect the active agentic framework
make cross-framework      # all of the above: export + bridge + cards

You want	Use instead
Set up uv, Python, tools from scratch	night-market-build-and-env
Classify a change, know which gates apply	night-market-change-control
Diagnose a failing test or broken hook	night-market-debugging-playbook
Configuration axes, env vars, defaults	night-market-config-catalog
Coverage discipline and evidence bar	night-market-validation-and-qa
Plugin/skill/hook mechanics	claude-code-plugin-reference
Measurement tooling interpretation	night-market-diagnostics-toolkit
Stop an egregore loop or its watchdog relaunch machinery	night-market-completion-integrity-campaign (P1b, "Stopping and relaunch machinery")

# Make target wiring
sed -n '60,150p' Makefile && sed -n '150,300p' Makefile

# Test runner behavior (delegation, coverage threshold, skip logic)
sed -n '1,110p' scripts/run-plugin-tests.sh

# Version bump globs and semver regex
rg -n "patterns|re.match" plugins/sanctum/scripts/update_versions.py

# Release pipeline gates
rg -n "tags|total_exported|tar -czf" \
  .github/workflows/cross-framework-publish.yml

# Attestation flow
rg -n "make test|attest|trust-report" \
  .github/workflows/trust-attestation.yml

# Book deploy and mdbook pin
rg -n "mdbook-version|deploy-pages|working-directory" \
  .github/workflows/deploy-book.yml

# Current export count (was 188 on 2026-07-02)
python3 -c "import json; \
  print(json.load(open('clawhub/manifest.json'))['total_exported'])"

# Coverage thresholds
rg -n "coverage_threshold" plugins/*/pyproject.toml
rg -n "fail_under" pyproject.toml