v0.10.1

[0.10.1] - 2026-09-14

Changed

• Observability guidance targets ArchiPy 5.4.0 METRICS_EXPORTER=pushgateway (METRICS_PUSHGATEWAY_*),
  OtelUtils.metrics_registry(), and scrape-bind isolation (pull port conflict no longer kills traces/logs)

v0.10.0

Added

• /scaffold-models command and scaffold-archipy-models skill for domain/repository DTOs, errors, and optional
  entities — /scaffold-domain and /scaffold-logic compose it instead of inlining model stubs

Fixed

• Slash commands are now self-contained for Cursor: every scaffold-* command and /redis-search carries an explicit
  skills/<skill>/SKILL.md path (bold skill names alone did not resolve), a mandatory read list, inspect/ask steps,
  inlined key constraints, and a Verify + report section — Cursor no longer skips the skill and hallucinates layouts
• Plugin-relative paths (../skills/... in commands, ../... across skills) now state they resolve from the plugin
  installation ($CURSOR_PLUGIN_ROOT / $CLAUDE_PLUGIN_ROOT), not the app workspace, so symlinked and marketplace
  installs resolve skill and template files
• Docs commands reference ../skills/archipy-docs/SKILL.md by explicit path
• BDD mocks-mode verify skips every @needs-* tag present, not only @needs-redis
• /scaffold-logic installs a Postgres SQLAlchemy extra and UoW decorator only when that stack is in play
• Service bootstrap exports create_<domain>_v{n}_router instead of a hardcoded create_user_v1_router
• Custom timed() decorator example rejects coroutine functions to match the sync-wrapper constraint

Changed

• Catalog guard check_command_skill_refs now binds each command to its canonical skill path, requires archipy-docs
  for docs-*, and matches a ## Do not heading (not the preamble Do not rely)

Tests

• Added regression coverage for the explicit skill-path requirement, mismatched skill paths, preamble-only Do not,
  docs-command path binding, and the passing self-contained command shape

v0.9.1

Changed

• Observability guidance targets ArchiPy 5.2.x: unique METRICS_EXPORTER /
  LOGS_EXPORTER, pull scrape defaults, console log stream split, and
  SYSTEM_METRICS_ENABLED
• Document AppUtils gRPC rpc.server.duration metrics interceptors
  (independent of traces) in reference, scaffold skill, utils/interceptor rules,
  and /docs-observability

v0.9.0

Added

• /scaffold-observability and ArchiPy 5.x OpenTelemetry setup guidance
• Consumer app rules for style, typing, security, tooling, contributions, and rule precedence
• Catalog guards for skill quality, prompt parity, templates, rule metadata, and ArchiPy API drift

Changed

• Scaffolding now inspects existing projects, preserves files, asks only unresolved choices, and verifies output
• Bundled docs and rules now align with ArchiPy 5.1, BaseDTO, AppUtils error mapping, and current BDD patterns

Fixed

• Removed stale ArchiPy 4.x observability APIs and extras
• Removed redundant gRPC health dependency installation and corrected service documentation

Tests

• Added regression coverage for scaffold workflows, references, API drift, and Claude rule injection

v0.8.0

Summary

Cursor and Claude Code both load the plugin for real. Claude Code was previously pointed at Cursor hook JSON and never received .mdc rules.

Added

• hooks/claude-hooks.json with Claude Code schema (SessionStart / PostToolUse)
• Claude hooks inject matching .mdc rule bodies (Claude Code does not load Cursor rules)
• Explicit skills / commands / hooks paths in both manifests; Cursor also sets rules

Changed

• Description and keywords: Cursor and Claude Code
• Cursor keeps hooks/hooks.json; Claude manifest uses hooks/claude-hooks.json

See CHANGELOG.md for full notes.

v0.7.0

Summary

Plugin accuracy + infra overhaul against archipy 4.17.x.

Fixed

• Wrong extras (postgres-sqlalchemy* → postgres / sqlalchemy / sqlalchemy-async)
• Symbol names (JWTUtils, ttl_cache_decorator, real decorator APIs)
• Utils import paths (full submodules)
• @atomic clarified as shorthand for *_sqlalchemy_atomic_decorator
• redis-search on RedisAdapter.search_index() (no raw client.ft())
• gRPC health: "" / readiness start NOT_SERVING

Changed

• Slim BDD / health / redis skills → reference/ templates
• Trimmed always-on architecture rule + hook noise
• Narrowed rule globs; expanded reference.md to all published extras + Observability

Added

• Stronger check_catalog.py, tests, CI on Python 3.14 + link check
• Issue/PR templates, Dependabot

See CHANGELOG.md for full notes.

v0.6.0

What's Changed

Added

• Command: /redis-search (slash entry for existing skill)
• Concrete stubs in redis-search, scaffold-archipy-domain, and helper skills
• scripts/check_catalog.py + GitHub Actions CI for version/catalog sync
• hooks/hooks.json + scripts/scaffold_hygiene.py (hard-rules context; warn on top-level adapters/)
• CONTRIBUTING.md for dual-IDE version bump + catalog checklist

Changed

• README: Skills (12), Commands (19); docs map includes redis-search and health
• Decorator skill/command: postgres_sqlalchemy_atomic_decorator
• archipy-docs topics: Testing, Observability, Redis search
• Health skill + config rule point at reference.md for canonical prose

Full changelog: https://github.com/SyntaxArc/archipy-plugin/blob/main/CHANGELOG.md

v0.5.0: Health Checks (HTTP + gRPC)

What's Changed

Added

• Skill: scaffold-archipy-health-checks for FastAPI /health/live + /health/ready and gRPC grpc.health.v1 Health servicer
• Commands: /scaffold-health-checks, /docs-health-checks
• Bundled health-check guidance in skills/archipy-docs/reference.md (probe types, K8s httpGet/grpc probes, graceful shutdown)
• Changelog history restored for 0.3.0 and 0.4.0

Notes

• Ask transport: FastAPI, gRPC (sync/async), or both
• Optional Kubernetes probe YAML with drain/preStop guidance
• Prefer AppUtils.create_fastapi_app / create_grpc_app / create_async_grpc_app

Full Changelog: v0.4.0...v0.5.0

v0.4.0: Redis Search Skills

What's Changed

New Features

• Added Redis search skill with support for:
  • Full-text search (RediSearch module)
  • Vector search for embeddings/AI
  • Search caching patterns
• Skill provides scaffolding for domain adapters under repositories/{domain}/adapters/

Technical Details

• Follows ArchiPy adapter patterns
• Supports both sync and async implementations
• Includes DI wiring guidelines
• Maintains separation of concerns with business logic in logics, not adapters

Full Changelog: https://github.com/your-org/archipy-plugin/compare/v0.3.0...v0.4.0

v0.3.0

What's new

• Claude Code support — add via /plugin marketplace add SyntaxArc/archipy-plugin
• Added .claude-plugin/ manifest and marketplace catalog
• Added .cursor-plugin/marketplace.json for multi-plugin discovery
• Renamed repo from archipy-cursor-plugin to archipy-plugin

Install

Cursor: ln -sfn "$(pwd)" ~/.cursor/plugins/local/archipy
Claude Code: /plugin marketplace add SyntaxArc/archipy-plugin