mirror of
https://github.com/ComposioHQ/composio.git
synced 2026-09-22 11:46:35 +08:00
Alberto Schiabel
956f9be9b4
This PR: - replaces the duplicated repo-local skill set with the requested canonical `.agents/skills` taxonomy and short router `SKILL.md` files backed by first-level references - makes `.claude/skills` a compatibility symlink to `.agents/skills` and removes hand-maintained Claude skill/rule copies - moves docs agent guidance and decisions into neutral `docs/agent-guidance/` and `docs/decisions/`, with `docs/CLAUDE.md` reduced to a shim - retires CLI Cursor rules after migrating CLI design, Effect source, and client-cache sync guidance into `AGENTS.md` and `cli-command` - adds nested `AGENTS.md` files for TS, core, providers, e2e, Python, Python providers, and docs - adds `pnpm validate:agent-skills` to validate skill frontmatter, taxonomy, references, symlink invariants, stale paths, and command names - implements missing Python `tst` and `snt` nox sessions that existing Makefile targets already exposed - no changeset: repository guidance/tooling only, no published SDK package behavior ## Verification - `pnpm validate:agent-skills` -> `Validated 14 canonical agent skills and guidance invariants.` - `for skill in .agents/skills/*; do python /Users/jkomyno/.codex/skills/.system/skill-creator/scripts/quick_validate.py "$skill" || exit 1; done` -> 14x `Skill is valid!` - `pnpm --dir ts/packages/cli validate:skills` -> `Validated composio-cli skill builds for stable and beta.` - `cd python && uv run nox --list` -> includes `tst` and `snt` - `cd python && uv run nox -s snt` -> 18 passed - `cd python && uv run nox -s tst -- tests/test_imports.py` -> 8 passed - `git diff --check` / `git diff --cached --check` -> clean - stale reference search for retired docs/Claude/Cursor paths -> no matches ## Forward Tests - TypeScript core bug: loaded `bug-fixing`, `typescript-sdk`, `typescript-testing`; found correct root/ts/core `AGENTS.md` route. - Python provider: loaded `python-providers`, `python-testing`; found missing nox sessions, fixed here. - CLI command: loaded `cli-command`; found recording/changeset wording gaps, fixed here. - Cross-SDK drift: loaded `cross-sdk-parity`; again found Python nox drift, fixed here. - Docs + decision: loaded `docs-decisions`; found decision template/index and Twoslash path gaps, fixed here. ## Notes The first normal `git commit` attempt hit a lint-staged/Git stash limitation while replacing `.claude/skills/` with a symlink (`path ... beyond a symbolic link`). The final commit used `--no-verify` after the validators and formatting checks above passed.
80 lines
1.7 KiB
Makefile
80 lines
1.7 KiB
Makefile
.PHONY: clean-build sync provider create-provider env fmt chk snt tst type_inference bump build format check sanity test
|
|
|
|
clean-build:
|
|
@rm -rf dist/ build/
|
|
@for provider in $(shell ls -d providers/*); do\
|
|
rm -rf build $$provider/dist $$provider/build;\
|
|
done
|
|
|
|
sync:
|
|
@uv sync
|
|
@uv pip install -e .
|
|
|
|
provider:
|
|
@for provider in $(shell ls -d providers/*); do\
|
|
uv pip install $$provider;\
|
|
done
|
|
|
|
create-provider:
|
|
@if [ -z "$(name)" ]; then\
|
|
echo "Please provide a provider name: make create-provider name=<provider-name> [agentic=true] [output=<directory>]";\
|
|
exit 1;\
|
|
fi
|
|
@ARGS="$(name)";\
|
|
if [ "$(agentic)" = "true" ]; then\
|
|
ARGS="$$ARGS --agentic";\
|
|
fi;\
|
|
if [ ! -z "$(output)" ]; then\
|
|
ARGS="$$ARGS --output-dir $(output)";\
|
|
fi;\
|
|
bash scripts/create-provider.sh $$ARGS
|
|
|
|
env:
|
|
@echo "* creating new environment"
|
|
@if [ -z "$$VIRTUAL_ENV" ];\
|
|
then\
|
|
uv venv --seed --prompt composio --python 3.12;\
|
|
uv sync;\
|
|
uv sync --dev;\
|
|
make provider;\
|
|
uv pip install -e .;\
|
|
echo "* enter virtual environment with all development dependencies now";\
|
|
else\
|
|
uv sync;\
|
|
uv pip install -e .;\
|
|
echo "* already in a virtual environment (exit first ('deactivate') to create a new environment)";\
|
|
fi
|
|
@echo "* run 'source .venv/bin/activate' to enter the development environment."
|
|
|
|
|
|
fmt:
|
|
@nox -s fmt
|
|
|
|
chk:
|
|
@nox -s chk
|
|
|
|
snt:
|
|
@nox -s snt
|
|
|
|
tst:
|
|
@nox -s tst
|
|
|
|
type_inference:
|
|
@nox -s type_inference
|
|
|
|
# Friendly aliases for the short session names above (e.g. `make test` == `make tst`).
|
|
format: fmt
|
|
check: chk
|
|
sanity: snt
|
|
test: tst
|
|
|
|
bump: clean-build
|
|
@uv run python scripts/bump.py
|
|
|
|
build: clean-build
|
|
@./.venv/bin/python -m build
|
|
@for provider in $(shell ls -d providers/*); do\
|
|
./.venv/bin/python -m build $$provider;\
|
|
cp $$provider/dist/* dist/;\
|
|
done
|