gabbe-kit 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +25 -0
- package/LICENSE-CODE +202 -0
- package/README.md +817 -0
- package/agents/AGENTS.md +542 -0
- package/agents/CONSTITUTION.md +188 -0
- package/agents/guides/00-index.md +142 -0
- package/agents/guides/ai/a2ui-protocols.md +71 -0
- package/agents/guides/ai/actor-agent-frameworks.md +82 -0
- package/agents/guides/ai/agent-communication.md +146 -0
- package/agents/guides/ai/agent-identity-trust.md +69 -0
- package/agents/guides/ai/agent-only-cognition.md +73 -0
- package/agents/guides/ai/agent-only-swarms.md +70 -0
- package/agents/guides/ai/agent-operating-ergonomics.md +52 -0
- package/agents/guides/ai/agent-ui.md +106 -0
- package/agents/guides/ai/ai-agentic.md +309 -0
- package/agents/guides/ai/beyond-llms.md +60 -0
- package/agents/guides/ai/dynamic-capability-loading.md +121 -0
- package/agents/guides/ai/gabbe-innovations.md +111 -0
- package/agents/guides/ai/model-customization-decisions.md +78 -0
- package/agents/guides/ai/multi-agent-systems.md +85 -0
- package/agents/guides/ai/self-evolving-skills.md +137 -0
- package/agents/guides/ai/self-healing-summary.md +21 -0
- package/agents/guides/ai/visual-mcp-integration.md +106 -0
- package/agents/guides/architecture/api-standards.md +61 -0
- package/agents/guides/architecture/blockchain-dlt.md +36 -0
- package/agents/guides/architecture/critical-systems-arch.md +66 -0
- package/agents/guides/architecture/event-driven-architecture.md +39 -0
- package/agents/guides/architecture/microservices.md +292 -0
- package/agents/guides/architecture/monolith.md +303 -0
- package/agents/guides/architecture/orchestration.md +75 -0
- package/agents/guides/architecture/system-qualities.md +51 -0
- package/agents/guides/architecture/system-scalability.md +47 -0
- package/agents/guides/architecture/systems-architecture.md +506 -0
- package/agents/guides/data/semantic-web.md +23 -0
- package/agents/guides/data/sql-nosql.md +305 -0
- package/agents/guides/industry/engineering-standards.md +36 -0
- package/agents/guides/industry/global-standards.md +24 -0
- package/agents/guides/industry/healthcare-fhir.md +33 -0
- package/agents/guides/industry/industrial-iot.md +33 -0
- package/agents/guides/industry/telecom-networks.md +34 -0
- package/agents/guides/languages/c-sharp.md +66 -0
- package/agents/guides/languages/go-lang.md +251 -0
- package/agents/guides/languages/java.md +73 -0
- package/agents/guides/languages/js-ts-nodejs.md +361 -0
- package/agents/guides/languages/nodejs-advanced.md +56 -0
- package/agents/guides/languages/php-laravel.md +376 -0
- package/agents/guides/languages/python-fastapi-ai.md +257 -0
- package/agents/guides/languages/rust.md +73 -0
- package/agents/guides/ops/compliance-audit.md +177 -0
- package/agents/guides/ops/cost-optimization.md +57 -0
- package/agents/guides/ops/dev-environments.md +67 -0
- package/agents/guides/ops/dev-workflow.md +44 -0
- package/agents/guides/ops/gabbe-cli-workflows.md +252 -0
- package/agents/guides/ops/production-health.md +62 -0
- package/agents/guides/ops/troubleshooting-guide.md +69 -0
- package/agents/guides/patterns/agentic-design-patterns.md +308 -0
- package/agents/guides/patterns/agentic-patterns.md +43 -0
- package/agents/guides/patterns/ai-native-scenarios.md +71 -0
- package/agents/guides/patterns/autonomous-swarm-patterns.md +42 -0
- package/agents/guides/patterns/design-patterns.md +68 -0
- package/agents/guides/patterns/enterprise-migration-scenario.md +58 -0
- package/agents/guides/patterns/enterprise-patterns.md +56 -0
- package/agents/guides/patterns/software-design-patterns.md +106 -0
- package/agents/guides/patterns/time-complexity-analysis.md +116 -0
- package/agents/guides/planning/product-requirements.md +407 -0
- package/agents/guides/planning/strategic-analysis.md +98 -0
- package/agents/guides/planning/visual-product-specs.md +162 -0
- package/agents/guides/principles/clean-code-standards.md +51 -0
- package/agents/guides/principles/computing-foundations.md +87 -0
- package/agents/guides/principles/diagramming-standards.md +568 -0
- package/agents/guides/principles/evaluation-strategy.md +103 -0
- package/agents/guides/principles/future-tech.md +35 -0
- package/agents/guides/principles/human-agent-collaboration.md +54 -0
- package/agents/guides/principles/legacy-tech.md +61 -0
- package/agents/guides/principles/mathematical-foundations.md +103 -0
- package/agents/guides/principles/modeling-methods.md +97 -0
- package/agents/guides/principles/no-code-integration.md +84 -0
- package/agents/guides/principles/testing-strategy.md +97 -0
- package/agents/guides/principles/visual-design-system.md +44 -0
- package/agents/guides/processes/RARV_CYCLE.md +262 -0
- package/agents/guides/processes/extension-protocol.md +183 -0
- package/agents/guides/processes/full-system-lifecycle.md +47 -0
- package/agents/guides/processes/knowledge-integration.md +82 -0
- package/agents/guides/processes/loki-sdlc-phases.md +446 -0
- package/agents/guides/product/green-software.md +38 -0
- package/agents/guides/product/sustainability-checks.md +29 -0
- package/agents/guides/security/ai-risk-standards-map.md +98 -0
- package/agents/guides/security/api-security.md +51 -0
- package/agents/guides/security/cryptography-standards.md +38 -0
- package/agents/guides/security/privacy-data-protection.md +41 -0
- package/agents/guides/security/secure-architecture.md +43 -0
- package/agents/guides/security/threat-modeling.md +46 -0
- package/agents/memory/AUDIT_LOG.md +48 -0
- package/agents/memory/CONTINUITY.md +49 -0
- package/agents/memory/PROJECT_STATE.md +134 -0
- package/agents/memory/RESUME_POINTER.md +15 -0
- package/agents/memory/episodic/DECISION_LOG_TEMPLATE.md +104 -0
- package/agents/memory/semantic/PROJECT_KNOWLEDGE_TEMPLATE.md +194 -0
- package/agents/memory/semantic/VECTOR_DB_CONFIG_TEMPLATE.json +46 -0
- package/agents/personas/00-index.md +148 -0
- package/agents/personas/biz-compliance.md +112 -0
- package/agents/personas/biz-legal.md +131 -0
- package/agents/personas/eng-api.md +110 -0
- package/agents/personas/eng-backend.md +113 -0
- package/agents/personas/eng-data.md +50 -0
- package/agents/personas/eng-database.md +95 -0
- package/agents/personas/eng-frontend.md +75 -0
- package/agents/personas/eng-infra.md +105 -0
- package/agents/personas/eng-messaging.md +50 -0
- package/agents/personas/eng-ml.md +50 -0
- package/agents/personas/eng-mobile.md +75 -0
- package/agents/personas/eng-perf.md +90 -0
- package/agents/personas/eng-qa.md +125 -0
- package/agents/personas/eng-tooling.md +49 -0
- package/agents/personas/ops-compliance.md +109 -0
- package/agents/personas/ops-cost.md +92 -0
- package/agents/personas/ops-devops.md +85 -0
- package/agents/personas/ops-incident.md +123 -0
- package/agents/personas/ops-monitor.md +89 -0
- package/agents/personas/ops-release.md +91 -0
- package/agents/personas/ops-security.md +104 -0
- package/agents/personas/ops-sre.md +85 -0
- package/agents/personas/orch-coordinator.md +140 -0
- package/agents/personas/orch-judge.md +135 -0
- package/agents/personas/orch-planner.md +114 -0
- package/agents/personas/orch-researcher.md +165 -0
- package/agents/personas/prod-architect.md +110 -0
- package/agents/personas/prod-design.md +112 -0
- package/agents/personas/prod-ethicist.md +50 -0
- package/agents/personas/prod-integration.md +120 -0
- package/agents/personas/prod-pm.md +115 -0
- package/agents/personas/prod-product-ops.md +128 -0
- package/agents/personas/prod-research.md +49 -0
- package/agents/personas/prod-safety-engineer.md +28 -0
- package/agents/personas/prod-tech-lead.md +119 -0
- package/agents/personas/ui-design.md +81 -0
- package/agents/scripts/check_skills_docs.py +120 -0
- package/agents/scripts/compile_skills.py +284 -0
- package/agents/scripts/comprehensive_checker.py +187 -0
- package/agents/scripts/dump-context.sh +37 -0
- package/agents/scripts/eval_skills.py +268 -0
- package/agents/scripts/preflight_summary.sh +80 -0
- package/agents/scripts/report_duplicates.py +125 -0
- package/agents/scripts/setup-context.ps1 +250 -0
- package/agents/scripts/setup-context.sh +398 -0
- package/agents/scripts/state_export.sh +84 -0
- package/agents/scripts/state_import.sh +99 -0
- package/agents/scripts/validate_integrity.py +98 -0
- package/agents/scripts/validate_links.py +96 -0
- package/agents/scripts/validate_methodology_graph.py +194 -0
- package/agents/scripts/validate_skills.py +81 -0
- package/agents/scripts/verify_e2e_init_flows.py +246 -0
- package/agents/scripts/verify_setup_simulation.py +104 -0
- package/agents/scripts/verify_triggers_and_mcps.py +159 -0
- package/agents/scripts/verify_use_cases.py +498 -0
- package/agents/skills/00-index.md +322 -0
- package/agents/skills/ai/a2ui-protocols.skill.md +31 -0
- package/agents/skills/ai/actor-agent-frameworks.skill.md +31 -0
- package/agents/skills/ai/agent-communication.skill.md +36 -0
- package/agents/skills/ai/agent-ui.skill.md +31 -0
- package/agents/skills/ai/autonomous-swarm-patterns.skill.md +31 -0
- package/agents/skills/ai/beyond-llms.skill.md +31 -0
- package/agents/skills/ai/context-engineering.skill.md +79 -0
- package/agents/skills/ai/llm-as-judge.skill.md +97 -0
- package/agents/skills/ai/multi-agent-systems.skill.md +31 -0
- package/agents/skills/ai/rag-evaluation.skill.md +93 -0
- package/agents/skills/ai/reasoning-patterns.skill.md +125 -0
- package/agents/skills/architecture/adaptive-architecture.skill.md +51 -0
- package/agents/skills/architecture/api-design.skill.md +92 -0
- package/agents/skills/architecture/api-standards.skill.md +31 -0
- package/agents/skills/architecture/arch-debt.skill.md +180 -0
- package/agents/skills/architecture/arch-design.skill.md +304 -0
- package/agents/skills/architecture/arch-patterns.skill.md +52 -0
- package/agents/skills/architecture/arch-review.skill.md +326 -0
- package/agents/skills/architecture/architecture-governance.skill.md +62 -0
- package/agents/skills/architecture/attribute-driven-design.skill.md +108 -0
- package/agents/skills/architecture/blockchain-dlt.skill.md +28 -0
- package/agents/skills/architecture/compatibility-design.skill.md +51 -0
- package/agents/skills/architecture/critical-systems-arch.skill.md +31 -0
- package/agents/skills/architecture/design-patterns.skill.md +59 -0
- package/agents/skills/architecture/diagramming.skill.md +380 -0
- package/agents/skills/architecture/domain-model.skill.md +294 -0
- package/agents/skills/architecture/enterprise-migration-scenario.skill.md +31 -0
- package/agents/skills/architecture/enterprise-patterns.skill.md +31 -0
- package/agents/skills/architecture/error-handling-strategy.skill.md +58 -0
- package/agents/skills/architecture/event-driven-architecture.skill.md +31 -0
- package/agents/skills/architecture/event-governance.skill.md +55 -0
- package/agents/skills/architecture/fitness-functions.skill.md +111 -0
- package/agents/skills/architecture/graphql-schema.skill.md +64 -0
- package/agents/skills/architecture/legacy-modernization.skill.md +51 -0
- package/agents/skills/architecture/microservices.skill.md +31 -0
- package/agents/skills/architecture/middleware-design.skill.md +59 -0
- package/agents/skills/architecture/monolith.skill.md +31 -0
- package/agents/skills/architecture/realtime-comm.skill.md +52 -0
- package/agents/skills/architecture/state-management.skill.md +72 -0
- package/agents/skills/architecture/system-qualities.skill.md +31 -0
- package/agents/skills/architecture/system-scalability.skill.md +31 -0
- package/agents/skills/architecture/systems-architecture.skill.md +31 -0
- package/agents/skills/architecture/visual-whiteboarding.skill.md +33 -0
- package/agents/skills/brain/README.md +70 -0
- package/agents/skills/brain/active-inference.skill.md +74 -0
- package/agents/skills/brain/brain-mode.skill.md +125 -0
- package/agents/skills/brain/cognitive-architectures.skill.md +53 -0
- package/agents/skills/brain/cognitive-testing.skill.md +62 -0
- package/agents/skills/brain/consciousness-loop.skill.md +68 -0
- package/agents/skills/brain/cost-benefit-router.skill.md +89 -0
- package/agents/skills/brain/episodic-consolidation.skill.md +43 -0
- package/agents/skills/brain/epistemology-knowledge.skill.md +54 -0
- package/agents/skills/brain/global-workspace.skill.md +77 -0
- package/agents/skills/brain/learning-adaptation.skill.md +68 -0
- package/agents/skills/brain/loki-mode.skill.md +267 -0
- package/agents/skills/brain/neuroscience-foundations.skill.md +52 -0
- package/agents/skills/brain/scripts/active_inference_loop.py +92 -0
- package/agents/skills/brain/scripts/cognition_test.py +80 -0
- package/agents/skills/brain/scripts/global_workspace.py +104 -0
- package/agents/skills/brain/self-improvement.skill.md +80 -0
- package/agents/skills/brain/sensory-motor.skill.md +61 -0
- package/agents/skills/brain/sequential-thinking.skill.md +48 -0
- package/agents/skills/brain/working-memory.skill.md +47 -0
- package/agents/skills/coding/agent-trajectory-eval.skill.md +92 -0
- package/agents/skills/coding/artisan-commands.skill.md +52 -0
- package/agents/skills/coding/browser-tdd.skill.md +131 -0
- package/agents/skills/coding/chaos-fault-injection.skill.md +116 -0
- package/agents/skills/coding/ci-autofix.skill.md +53 -0
- package/agents/skills/coding/clean-coder.skill.md +58 -0
- package/agents/skills/coding/code-review.skill.md +100 -0
- package/agents/skills/coding/debug.skill.md +100 -0
- package/agents/skills/coding/documentation.skill.md +149 -0
- package/agents/skills/coding/eval-driven-development.skill.md +107 -0
- package/agents/skills/coding/evals/code-review.eval.yaml +29 -0
- package/agents/skills/coding/excalidraw.skill.md +90 -0
- package/agents/skills/coding/file-processing.skill.md +55 -0
- package/agents/skills/coding/git-workflow.skill.md +153 -0
- package/agents/skills/coding/metamorphic-testing.skill.md +113 -0
- package/agents/skills/coding/mobile-dev.skill.md +41 -0
- package/agents/skills/coding/nodejs-expert.skill.md +23 -0
- package/agents/skills/coding/output-validation.skill.md +57 -0
- package/agents/skills/coding/pbt-strategy.skill.md +117 -0
- package/agents/skills/coding/performant-ai.skill.md +62 -0
- package/agents/skills/coding/performant-go.skill.md +61 -0
- package/agents/skills/coding/performant-laravel.skill.md +70 -0
- package/agents/skills/coding/performant-nodejs.skill.md +67 -0
- package/agents/skills/coding/performant-php.skill.md +53 -0
- package/agents/skills/coding/performant-python.skill.md +62 -0
- package/agents/skills/coding/refactor.skill.md +124 -0
- package/agents/skills/coding/secure-coding.skill.md +57 -0
- package/agents/skills/coding/sketch-to-diagram.skill.md +106 -0
- package/agents/skills/coding/spec-driven-development.skill.md +110 -0
- package/agents/skills/coding/tdd-cycle.skill.md +92 -0
- package/agents/skills/coding/testing-strategy.skill.md +74 -0
- package/agents/skills/coding/time-complexity.skill.md +112 -0
- package/agents/skills/coding/tldraw-canvas.skill.md +109 -0
- package/agents/skills/coding/tool-construction.skill.md +47 -0
- package/agents/skills/coding/ui-gen.skill.md +64 -0
- package/agents/skills/coding/vibe-coding.skill.md +63 -0
- package/agents/skills/coding/visual-design.skill.md +65 -0
- package/agents/skills/coordination/agent-interop.skill.md +72 -0
- package/agents/skills/coordination/agent-protocol.skill.md +62 -0
- package/agents/skills/coordination/agent-workflow-patterns.skill.md +123 -0
- package/agents/skills/coordination/agentic-linter.skill.md +134 -0
- package/agents/skills/coordination/agentic-patterns.skill.md +79 -0
- package/agents/skills/coordination/meta-optimize.skill.md +62 -0
- package/agents/skills/coordination/meta-prompting.skill.md +46 -0
- package/agents/skills/coordination/multi-agent-orch.skill.md +78 -0
- package/agents/skills/coordination/persona-selector.skill.md +78 -0
- package/agents/skills/coordination/self-optimize.skill.md +81 -0
- package/agents/skills/coordination/swarm-consensus.skill.md +52 -0
- package/agents/skills/core/agent-analytics.skill.md +74 -0
- package/agents/skills/core/audit-trail.skill.md +122 -0
- package/agents/skills/core/clarify.skill.md +89 -0
- package/agents/skills/core/emerging-tech.skill.md +52 -0
- package/agents/skills/core/empirical-methods.skill.md +101 -0
- package/agents/skills/core/evals/clarify.eval.yaml +29 -0
- package/agents/skills/core/evals/integrity-check.eval.yaml +23 -0
- package/agents/skills/core/evals/research.eval.yaml +23 -0
- package/agents/skills/core/final-review.skill.md +66 -0
- package/agents/skills/core/integrity-check.skill.md +149 -0
- package/agents/skills/core/knowledge-connect.skill.md +77 -0
- package/agents/skills/core/knowledge-gap.skill.md +123 -0
- package/agents/skills/core/preflight.skill.md +106 -0
- package/agents/skills/core/research.skill.md +107 -0
- package/agents/skills/core/retrospective.skill.md +59 -0
- package/agents/skills/core/sdlc-checkpoint.skill.md +151 -0
- package/agents/skills/core/self-heal.skill.md +163 -0
- package/agents/skills/core/session-resume.skill.md +125 -0
- package/agents/skills/core/skills-registry.skill.md +65 -0
- package/agents/skills/core/state-portability.skill.md +89 -0
- package/agents/skills/core/state-preserve.skill.md +76 -0
- package/agents/skills/core/system-lifecycle.skill.md +51 -0
- package/agents/skills/core/update-scan.skill.md +92 -0
- package/agents/skills/data/data-engineering.skill.md +56 -0
- package/agents/skills/data/data-governance.skill.md +49 -0
- package/agents/skills/data/db-migration.skill.md +136 -0
- package/agents/skills/data/semantic-web.skill.md +28 -0
- package/agents/skills/data/sql-optimization.skill.md +78 -0
- package/agents/skills/industry/engineering-standards.skill.md +31 -0
- package/agents/skills/industry/global-standards.skill.md +30 -0
- package/agents/skills/industry/healthcare-fhir.skill.md +28 -0
- package/agents/skills/industry/industrial-iot.skill.md +30 -0
- package/agents/skills/industry/telecom-networks.skill.md +30 -0
- package/agents/skills/ops/caching-strategy.skill.md +77 -0
- package/agents/skills/ops/capacity-planning.skill.md +67 -0
- package/agents/skills/ops/cloud-deploy.skill.md +55 -0
- package/agents/skills/ops/configuration-management.skill.md +107 -0
- package/agents/skills/ops/cost-optimization.skill.md +39 -0
- package/agents/skills/ops/decommission-sunset.skill.md +64 -0
- package/agents/skills/ops/dependency-lifecycle.skill.md +63 -0
- package/agents/skills/ops/deployment.skill.md +217 -0
- package/agents/skills/ops/dev-environments.skill.md +31 -0
- package/agents/skills/ops/dev-workflow.skill.md +28 -0
- package/agents/skills/ops/docker-dev.skill.md +52 -0
- package/agents/skills/ops/enterprise-integration.skill.md +53 -0
- package/agents/skills/ops/feature-flag-management.skill.md +59 -0
- package/agents/skills/ops/incident-response.skill.md +40 -0
- package/agents/skills/ops/infra-devops.skill.md +53 -0
- package/agents/skills/ops/k8s-dev.skill.md +51 -0
- package/agents/skills/ops/memory-optimization.skill.md +45 -0
- package/agents/skills/ops/observability-stack-setup.skill.md +62 -0
- package/agents/skills/ops/performance-audit.skill.md +178 -0
- package/agents/skills/ops/performance-optimization.skill.md +51 -0
- package/agents/skills/ops/production-health.skill.md +85 -0
- package/agents/skills/ops/production-verifier.skill.md +50 -0
- package/agents/skills/ops/queue-management.skill.md +52 -0
- package/agents/skills/ops/release-management.skill.md +39 -0
- package/agents/skills/ops/release-validation.skill.md +51 -0
- package/agents/skills/ops/reliability-sre.skill.md +51 -0
- package/agents/skills/ops/runbook-authoring.skill.md +64 -0
- package/agents/skills/ops/system-benchmark.skill.md +69 -0
- package/agents/skills/ops/tech-debt.skill.md +143 -0
- package/agents/skills/ops/troubleshooting-guide.skill.md +31 -0
- package/agents/skills/product/accessibility.skill.md +143 -0
- package/agents/skills/product/adr-writer.skill.md +110 -0
- package/agents/skills/product/business-case.skill.md +70 -0
- package/agents/skills/product/change-management.skill.md +90 -0
- package/agents/skills/product/decompose.skill.md +75 -0
- package/agents/skills/product/design-thinking.skill.md +62 -0
- package/agents/skills/product/estimation-sizing.skill.md +87 -0
- package/agents/skills/product/evals/spec-writer.eval.yaml +22 -0
- package/agents/skills/product/financial-governance.skill.md +88 -0
- package/agents/skills/product/green-software.skill.md +46 -0
- package/agents/skills/product/ideation-facilitation.skill.md +87 -0
- package/agents/skills/product/market-analysis.skill.md +56 -0
- package/agents/skills/product/opportunity-assessment.skill.md +89 -0
- package/agents/skills/product/product-analytics.skill.md +92 -0
- package/agents/skills/product/professional-practice.skill.md +105 -0
- package/agents/skills/product/req-elicitation.skill.md +292 -0
- package/agents/skills/product/req-review.skill.md +280 -0
- package/agents/skills/product/spec-analyze.skill.md +98 -0
- package/agents/skills/product/spec-writer.skill.md +114 -0
- package/agents/skills/product/stakeholder-management.skill.md +54 -0
- package/agents/skills/product/sustainability-checks.skill.md +29 -0
- package/agents/skills/product/systems-thinking.skill.md +56 -0
- package/agents/skills/product/user-research-synthesis.skill.md +85 -0
- package/agents/skills/product/user-story-mapping.skill.md +54 -0
- package/agents/skills/product/visual-specs.skill.md +112 -0
- package/agents/skills/security/access-control.skill.md +45 -0
- package/agents/skills/security/agent-sandboxing.skill.md +69 -0
- package/agents/skills/security/ai-ethics-compliance.skill.md +46 -0
- package/agents/skills/security/ai-red-teaming.skill.md +74 -0
- package/agents/skills/security/ai-safety-guardrails.skill.md +60 -0
- package/agents/skills/security/api-security.skill.md +31 -0
- package/agents/skills/security/backup-recovery.skill.md +49 -0
- package/agents/skills/security/compliance-review.skill.md +152 -0
- package/agents/skills/security/cryptography-standards.skill.md +31 -0
- package/agents/skills/security/dependency-security.skill.md +47 -0
- package/agents/skills/security/hazard-analysis.skill.md +53 -0
- package/agents/skills/security/legal-review.skill.md +41 -0
- package/agents/skills/security/log-analysis.skill.md +68 -0
- package/agents/skills/security/network-security.skill.md +64 -0
- package/agents/skills/security/privacy-audit.skill.md +137 -0
- package/agents/skills/security/privacy-data-protection.skill.md +31 -0
- package/agents/skills/security/prompt-injection-defense.skill.md +67 -0
- package/agents/skills/security/reliability-engineering.skill.md +47 -0
- package/agents/skills/security/safety-scan.skill.md +49 -0
- package/agents/skills/security/secrets-management.skill.md +65 -0
- package/agents/skills/security/secure-architecture.skill.md +31 -0
- package/agents/skills/security/security-audit.skill.md +164 -0
- package/agents/skills/security/threat-model.skill.md +120 -0
- package/agents/skills/security/traceability-audit.skill.md +48 -0
- package/agents/templates/00-index.md +162 -0
- package/agents/templates/architecture/ADAPTIVE_SYSTEM_TEMPLATE.md +35 -0
- package/agents/templates/architecture/ADD_WORKBOOK_TEMPLATE.md +81 -0
- package/agents/templates/architecture/ADR_TEMPLATE.md +136 -0
- package/agents/templates/architecture/ARCHITECTURE_DECISION_MATRIX.md +169 -0
- package/agents/templates/architecture/ARCHITECTURE_REVIEW_TEMPLATE.md +241 -0
- package/agents/templates/architecture/ARCHITECTURE_VIEWS_TEMPLATE.md +353 -0
- package/agents/templates/architecture/ARCH_DECISION_FRAMEWORK.md +32 -0
- package/agents/templates/architecture/C4_ARCHITECTURE_TEMPLATE.md +185 -0
- package/agents/templates/architecture/CAPABILITY_MAP_TEMPLATE.md +153 -0
- package/agents/templates/architecture/CONTEXT_MAP_TEMPLATE.md +196 -0
- package/agents/templates/architecture/DESIGN_PATTERN_USAGE.md +24 -0
- package/agents/templates/architecture/DOMAIN_MODEL_TEMPLATE.md +254 -0
- package/agents/templates/architecture/FITNESS_FUNCTION_TEMPLATE.md +59 -0
- package/agents/templates/architecture/INTEGRATION_SPEC_TEMPLATE.md +38 -0
- package/agents/templates/architecture/LEGACY_AUDIT_TEMPLATE.md +34 -0
- package/agents/templates/architecture/QUALITY_ATTRIBUTES_TEMPLATE.md +210 -0
- package/agents/templates/architecture/SCALABILITY_ANALYSIS_TEMPLATE.md +46 -0
- package/agents/templates/architecture/SMART_CONTRACT_TEMPLATE.md +44 -0
- package/agents/templates/architecture/SYSTEM_CONTEXT_TEMPLATE.md +197 -0
- package/agents/templates/brain/ACTIVE_INFERENCE_LOOP_TEMPLATE.md +42 -0
- package/agents/templates/brain/EPISODIC_MEMORY_LOG_TEMPLATE.md +28 -0
- package/agents/templates/brain/GLOBAL_WORKSPACE_CONFIG_TEMPLATE.md +44 -0
- package/agents/templates/brain/KNOWLEDGE_MAP_TEMPLATE.md +53 -0
- package/agents/templates/brain/OODA_LOOP_TRACE_TEMPLATE.md +44 -0
- package/agents/templates/brain/PREDICTION_ERROR_LOG_TEMPLATE.md +33 -0
- package/agents/templates/brain/PROJECT_CONTEXT_TEMPLATE.md +36 -0
- package/agents/templates/brain/SELF_IMPROVEMENT_LOG_TEMPLATE.md +39 -0
- package/agents/templates/brain/WORKING_MEMORY_TEMPLATE.md +34 -0
- package/agents/templates/coding/CLEAN_CODE_CHECKLIST.md +30 -0
- package/agents/templates/coding/DESIGN_TOKENS_TEMPLATE.json +54 -0
- package/agents/templates/coding/DEVCONTAINER_TEMPLATE.json +42 -0
- package/agents/templates/coding/DEV_SPACE_TEMPLATE.yaml +48 -0
- package/agents/templates/coding/E2E_TEST_SUITE_TEMPLATE.md +36 -0
- package/agents/templates/coding/EVAL_PLAN_TEMPLATE.md +85 -0
- package/agents/templates/coding/EVAL_RUBRIC_TEMPLATE.md +57 -0
- package/agents/templates/coding/GOLDEN_DATASET_TEMPLATE.md +73 -0
- package/agents/templates/coding/PROPERTY_TEST_CHECKLIST.md +77 -0
- package/agents/templates/coding/SKETCH_TO_DIAGRAM_TEMPLATE.md +56 -0
- package/agents/templates/coding/TEST_CASE_TEMPLATE.md +28 -0
- package/agents/templates/coding/TEST_PLAN_TEMPLATE.md +36 -0
- package/agents/templates/coding/TIME_COMPLEXITY_REPORT_TEMPLATE.md +61 -0
- package/agents/templates/coordination/AGENTS_TEMPLATE.md +540 -0
- package/agents/templates/coordination/AGENT_HANDSHAKE_TEMPLATE.json +37 -0
- package/agents/templates/coordination/AGENT_PROFILE_TEMPLATE.md +28 -0
- package/agents/templates/coordination/SWARM_ARCHITECTURE_TEMPLATE.md +53 -0
- package/agents/templates/coordination/SWARM_CONFIG_TEMPLATE.json +45 -0
- package/agents/templates/core/AUDIT_LOG_TEMPLATE.md +75 -0
- package/agents/templates/core/BUG_REPORT_TEMPLATE.md +136 -0
- package/agents/templates/core/DEPENDENCY_GRAPH_TEMPLATE.md +63 -0
- package/agents/templates/core/ESTIMATION_TEMPLATE.md +70 -0
- package/agents/templates/core/MCP_CONFIG_TEMPLATE.json +807 -0
- package/agents/templates/core/PLAN_TEMPLATE.md +162 -0
- package/agents/templates/core/PROJECT_RETROSPECTIVE_TEMPLATE.md +67 -0
- package/agents/templates/core/SDLC_TRACKER.md +217 -0
- package/agents/templates/core/SESSION_SNAPSHOT_TEMPLATE.md +168 -0
- package/agents/templates/core/SYSTEM_ANALYSIS_TEMPLATE.md +52 -0
- package/agents/templates/core/TASKS_TEMPLATE.md +104 -0
- package/agents/templates/core/TRACEABILITY_MATRIX_TEMPLATE.md +18 -0
- package/agents/templates/core/WHITEBOARD_DESIGN_TEMPLATE.md +46 -0
- package/agents/templates/data/DATABASE_SCHEMA_TEMPLATE.md +38 -0
- package/agents/templates/data/DATA_PIPELINE_TEMPLATE.md +44 -0
- package/agents/templates/data/ONTOLOGY_TEMPLATE.md +52 -0
- package/agents/templates/industry/ENGINEERING_STANDARDS_REVIEW_TEMPLATE.md +43 -0
- package/agents/templates/industry/FHIR_INTEGRATION_TEMPLATE.md +53 -0
- package/agents/templates/industry/GLOBAL_STANDARDS_AUDIT_TEMPLATE.md +45 -0
- package/agents/templates/industry/IOT_TELEMETRY_TEMPLATE.md +59 -0
- package/agents/templates/industry/TELECOM_API_TEMPLATE.md +50 -0
- package/agents/templates/ops/BENCHMARK_REPORT_TEMPLATE.md +48 -0
- package/agents/templates/ops/CAPACITY_PLAN_TEMPLATE.md +41 -0
- package/agents/templates/ops/COST_OPTIMIZATION_REPORT_TEMPLATE.md +40 -0
- package/agents/templates/ops/DECOMMISSION_PLAN_TEMPLATE.md +102 -0
- package/agents/templates/ops/DEPLOY_CONFIG_TEMPLATE.md +88 -0
- package/agents/templates/ops/INCIDENT_POSTMORTEM_TEMPLATE.md +39 -0
- package/agents/templates/ops/INFRA_PLAN_TEMPLATE.md +37 -0
- package/agents/templates/ops/RELEASE_READINESS_REPORT.md +35 -0
- package/agents/templates/ops/RUNBOOK_TEMPLATE.md +103 -0
- package/agents/templates/ops/TECH_DEBT_TEMPLATE.md +102 -0
- package/agents/templates/product/BUSINESS_CASE_TEMPLATE.md +42 -0
- package/agents/templates/product/CHANGE_MANAGEMENT_PLAN_TEMPLATE.md +68 -0
- package/agents/templates/product/EMPATHY_MAP_TEMPLATE.md +47 -0
- package/agents/templates/product/EXPERIMENT_PLAN_TEMPLATE.md +84 -0
- package/agents/templates/product/GREEN_SOFTWARE_REPORT_TEMPLATE.md +42 -0
- package/agents/templates/product/IDEATION_LOG_TEMPLATE.md +42 -0
- package/agents/templates/product/NFR_TEMPLATE.md +31 -0
- package/agents/templates/product/PRD_TEMPLATE.md +222 -0
- package/agents/templates/product/PROBLEM_STATEMENT_TEMPLATE.md +32 -0
- package/agents/templates/product/REQUIREMENTS_REVIEW_TEMPLATE.md +173 -0
- package/agents/templates/product/SPEC_TEMPLATE.md +259 -0
- package/agents/templates/product/STAKEHOLDER_REGISTER_TEMPLATE.md +127 -0
- package/agents/templates/product/USER_STORY_MAP_TEMPLATE.md +35 -0
- package/agents/templates/product/VISUAL_SPEC_PACKAGE_TEMPLATE.md +207 -0
- package/agents/templates/security/DATASHEET_TEMPLATE.md +95 -0
- package/agents/templates/security/ETHICAL_IMPACT_ASSESSMENT.md +32 -0
- package/agents/templates/security/HAZARD_LOG.md +17 -0
- package/agents/templates/security/MODEL_CARD_TEMPLATE.md +120 -0
- package/agents/templates/security/SAFETY_CASE.md +39 -0
- package/agents/templates/security/SAFETY_POLICY.md +25 -0
- package/agents/templates/security/SECURITY_CHECKLIST.md +157 -0
- package/agents/templates/security/SYSTEM_CARD_TEMPLATE.md +139 -0
- package/agents/templates/security/THREAT_MODEL_TEMPLATE.md +171 -0
- package/bin/install.js +572 -0
- package/docs/CLI_REFERENCE.md +527 -0
- package/docs/INSTALL.md +68 -0
- package/docs/MCP_CONFIGURATIONS.md +1765 -0
- package/docs/PLATFORM_CONTROLS.md +324 -0
- package/docs/POST_INSTALL.md +75 -0
- package/docs/QUICK_COMMANDS.md +131 -0
- package/docs/QUICK_GUIDE.md +914 -0
- package/docs/README_FULL.md +1451 -0
- package/docs/SCHEMA.md +164 -0
- package/docs/V1_RELEASE_CHECKLIST.md +144 -0
- package/docs/VERIFICATION_GUIDE.md +283 -0
- package/docs/adr/0001-record-architecture-decisions.md +26 -0
- package/docs/adr/0002-brain-active-inference-runtime.md +27 -0
- package/docs/adr/0003-additive-only-emitter-schema-evolution.md +33 -0
- package/docs/assets/GABBE.png +0 -0
- package/docs/gabbe.config.example.json +9 -0
- package/docs/reports/duplication-report.md +30 -0
- package/install.ps1 +90 -0
- package/install.sh +89 -0
- package/package.json +49 -0
- package/scripts/init.py +1036 -0
|
@@ -0,0 +1,246 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
import os
|
|
4
|
+
import subprocess
|
|
5
|
+
import sys
|
|
6
|
+
import tempfile
|
|
7
|
+
from pathlib import Path
|
|
8
|
+
|
|
9
|
+
PROJECT_ROOT = Path(__file__).resolve().parent.parent.parent
|
|
10
|
+
INIT_SCRIPT = PROJECT_ROOT / "scripts" / "init.py"
|
|
11
|
+
GABBE_EXEC = sys.executable + " -m gabbe.main"
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
def run_init(inputs, env, cwd):
|
|
15
|
+
process = subprocess.run(
|
|
16
|
+
[sys.executable, str(INIT_SCRIPT)],
|
|
17
|
+
input="\n".join(inputs) + "\n",
|
|
18
|
+
text=True,
|
|
19
|
+
env=env,
|
|
20
|
+
cwd=str(cwd),
|
|
21
|
+
capture_output=True,
|
|
22
|
+
)
|
|
23
|
+
if process.returncode != 0:
|
|
24
|
+
print(f"FAILED. STDOUT: {process.stdout}\nSTDERR: {process.stderr}")
|
|
25
|
+
sys.exit(1)
|
|
26
|
+
return process.stdout
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
def run_gabbe_command(cmd, env, cwd):
|
|
30
|
+
process = subprocess.run(cmd, text=True, env=env, cwd=str(cwd), capture_output=True, shell=True)
|
|
31
|
+
# gabbe verify is expected to fail with exit code 1 due to [PLACEHOLDER] variables inside a freshly initialized setup.
|
|
32
|
+
# The success state is it finding the placeholders instead of crashing.
|
|
33
|
+
if "gabbe verify" in cmd and process.returncode != 0:
|
|
34
|
+
if (
|
|
35
|
+
"Verification FAILED" in process.stdout
|
|
36
|
+
or "Placeholder" in process.stdout
|
|
37
|
+
or "Found" in process.stdout
|
|
38
|
+
or "Missing" in process.stdout
|
|
39
|
+
):
|
|
40
|
+
return (
|
|
41
|
+
process.stdout
|
|
42
|
+
) # This is expected behavior for edge case where human needs to input stuff
|
|
43
|
+
elif process.returncode != 0:
|
|
44
|
+
print(f"GABBE FAILED. STDOUT: {process.stdout}\nSTDERR: {process.stderr}")
|
|
45
|
+
sys.exit(1)
|
|
46
|
+
return process.stdout
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
def create_mock_user_files(agents_dir):
|
|
50
|
+
(agents_dir / "AGENTS.md").write_text("custom user agents")
|
|
51
|
+
(agents_dir / "CONSTITUTION.md").write_text("my custom rules")
|
|
52
|
+
mem_dir = agents_dir / "memory" / "episodic"
|
|
53
|
+
mem_dir.mkdir(parents=True, exist_ok=True)
|
|
54
|
+
(mem_dir / "SESSION_SNAPSHOT.md").write_text("mem")
|
|
55
|
+
|
|
56
|
+
proj_dir = agents_dir / "project"
|
|
57
|
+
proj_dir.mkdir(parents=True, exist_ok=True)
|
|
58
|
+
(proj_dir / "TASKS.md").write_text("my custom tasks")
|
|
59
|
+
(proj_dir / "policies.yml").write_text("my custom policy")
|
|
60
|
+
(proj_dir / "config.json").write_text('{"key": "value"}')
|
|
61
|
+
|
|
62
|
+
|
|
63
|
+
def verify_mock_user_files(agents_dir):
|
|
64
|
+
assert (agents_dir / "AGENTS.md").read_text() == "custom user agents", "AGENTS.md overwritten"
|
|
65
|
+
assert (
|
|
66
|
+
agents_dir / "CONSTITUTION.md"
|
|
67
|
+
).read_text() == "my custom rules", "CONSTITUTION.md overwritten"
|
|
68
|
+
assert (
|
|
69
|
+
agents_dir / "memory" / "episodic" / "SESSION_SNAPSHOT.md"
|
|
70
|
+
).read_text() == "mem", "memory overwritten"
|
|
71
|
+
|
|
72
|
+
# Adding specific project files per user request
|
|
73
|
+
assert (
|
|
74
|
+
agents_dir / "project" / "TASKS.md"
|
|
75
|
+
).read_text() == "my custom tasks", "TASKS.md overwritten"
|
|
76
|
+
assert (
|
|
77
|
+
agents_dir / "project" / "policies.yml"
|
|
78
|
+
).read_text() == "my custom policy", "policies.yml overwritten"
|
|
79
|
+
assert (
|
|
80
|
+
agents_dir / "project" / "config.json"
|
|
81
|
+
).read_text() == '{"key": "value"}', "config.json overwritten"
|
|
82
|
+
|
|
83
|
+
|
|
84
|
+
def test_global_flow():
|
|
85
|
+
with tempfile.TemporaryDirectory() as td:
|
|
86
|
+
mock_home = Path(td) / "mock_home"
|
|
87
|
+
mock_home.mkdir()
|
|
88
|
+
cwd = Path(td) / "project"
|
|
89
|
+
cwd.mkdir()
|
|
90
|
+
env = os.environ.copy()
|
|
91
|
+
env["HOME"] = str(mock_home)
|
|
92
|
+
env["PYTHONPATH"] = str(PROJECT_ROOT) + os.pathsep + env.get("PYTHONPATH", "")
|
|
93
|
+
|
|
94
|
+
print("Testing Global Install Flow...")
|
|
95
|
+
inputs = ["2", "", "", "1", "1", "3", "", "6", "7", "n", "n", "n", "n", "7"] # Global
|
|
96
|
+
out = run_init(inputs, env, cwd)
|
|
97
|
+
expected_agents = mock_home / "agents"
|
|
98
|
+
assert expected_agents.exists()
|
|
99
|
+
assert (expected_agents / "AGENTS.md").exists()
|
|
100
|
+
|
|
101
|
+
print("Testing Global CLI Verify edges (checking logic flows)...")
|
|
102
|
+
# Set agent dir to the global space we just mapped
|
|
103
|
+
env["GABBE_AGENTS_DIR"] = str(expected_agents)
|
|
104
|
+
run_gabbe_command(f"{GABBE_EXEC} init", env, cwd)
|
|
105
|
+
run_gabbe_command(f"{GABBE_EXEC} sync", env, cwd)
|
|
106
|
+
verify_out = run_gabbe_command(f"{GABBE_EXEC} verify", env, cwd)
|
|
107
|
+
# Assuming it catches placeholders:
|
|
108
|
+
assert verify_out is not None
|
|
109
|
+
|
|
110
|
+
print("Testing Global Update Flow...")
|
|
111
|
+
create_mock_user_files(expected_agents)
|
|
112
|
+
inputs_update = [
|
|
113
|
+
"2", # Global
|
|
114
|
+
"y", # Merge
|
|
115
|
+
"",
|
|
116
|
+
"",
|
|
117
|
+
"1",
|
|
118
|
+
"1",
|
|
119
|
+
"3",
|
|
120
|
+
"",
|
|
121
|
+
"6",
|
|
122
|
+
"7",
|
|
123
|
+
"n",
|
|
124
|
+
"n",
|
|
125
|
+
"n",
|
|
126
|
+
"n",
|
|
127
|
+
"7",
|
|
128
|
+
]
|
|
129
|
+
out_update = run_init(inputs_update, env, cwd)
|
|
130
|
+
verify_mock_user_files(expected_agents)
|
|
131
|
+
assert "Preserved user file(s): AGENTS.md" in out_update
|
|
132
|
+
print("[PASS] Global flows safely tested.\n")
|
|
133
|
+
|
|
134
|
+
|
|
135
|
+
def test_local_flow():
|
|
136
|
+
with tempfile.TemporaryDirectory() as td:
|
|
137
|
+
cwd = Path(td) / "project"
|
|
138
|
+
cwd.mkdir()
|
|
139
|
+
env = os.environ.copy()
|
|
140
|
+
env["PYTHONPATH"] = str(PROJECT_ROOT) + os.pathsep + env.get("PYTHONPATH", "")
|
|
141
|
+
|
|
142
|
+
print("Testing Local Install Flow...")
|
|
143
|
+
inputs = ["1", "", "", "1", "1", "3", "", "6", "7", "n", "n", "n", "n", "7"] # Local
|
|
144
|
+
out = run_init(inputs, env, cwd)
|
|
145
|
+
expected_agents = cwd / "agents"
|
|
146
|
+
assert expected_agents.exists()
|
|
147
|
+
|
|
148
|
+
print("Testing Local CLI Verify edges (checking logic flows)...")
|
|
149
|
+
run_gabbe_command(f"{GABBE_EXEC} init", env, cwd)
|
|
150
|
+
run_gabbe_command(f"{GABBE_EXEC} sync", env, cwd)
|
|
151
|
+
verify_out = run_gabbe_command(f"{GABBE_EXEC} verify", env, cwd)
|
|
152
|
+
assert verify_out is not None
|
|
153
|
+
|
|
154
|
+
print("Testing Local Update Flow...")
|
|
155
|
+
create_mock_user_files(expected_agents)
|
|
156
|
+
inputs_update = [
|
|
157
|
+
"1", # Local
|
|
158
|
+
"y", # Merge
|
|
159
|
+
"",
|
|
160
|
+
"",
|
|
161
|
+
"1",
|
|
162
|
+
"1",
|
|
163
|
+
"3",
|
|
164
|
+
"",
|
|
165
|
+
"6",
|
|
166
|
+
"7",
|
|
167
|
+
"n",
|
|
168
|
+
"n",
|
|
169
|
+
"n",
|
|
170
|
+
"n",
|
|
171
|
+
"7",
|
|
172
|
+
]
|
|
173
|
+
out_update = run_init(inputs_update, env, cwd)
|
|
174
|
+
verify_mock_user_files(expected_agents)
|
|
175
|
+
assert "Preserved user file(s): AGENTS.md" in out_update
|
|
176
|
+
print("[PASS] Local flows safely tested.\n")
|
|
177
|
+
|
|
178
|
+
|
|
179
|
+
def test_custom_flow():
|
|
180
|
+
with tempfile.TemporaryDirectory() as td:
|
|
181
|
+
cwd = Path(td) / "project"
|
|
182
|
+
cwd.mkdir()
|
|
183
|
+
custom_dir = Path(td) / "custom_agents"
|
|
184
|
+
env = os.environ.copy()
|
|
185
|
+
env["PYTHONPATH"] = str(PROJECT_ROOT) + os.pathsep + env.get("PYTHONPATH", "")
|
|
186
|
+
|
|
187
|
+
print("Testing Custom Install Flow...")
|
|
188
|
+
inputs = [
|
|
189
|
+
"3", # Custom
|
|
190
|
+
str(custom_dir),
|
|
191
|
+
"",
|
|
192
|
+
"",
|
|
193
|
+
"1",
|
|
194
|
+
"1",
|
|
195
|
+
"3",
|
|
196
|
+
"",
|
|
197
|
+
"6",
|
|
198
|
+
"7",
|
|
199
|
+
"n",
|
|
200
|
+
"n",
|
|
201
|
+
"n",
|
|
202
|
+
"n",
|
|
203
|
+
"7",
|
|
204
|
+
]
|
|
205
|
+
out = run_init(inputs, env, cwd)
|
|
206
|
+
assert custom_dir.exists()
|
|
207
|
+
|
|
208
|
+
print("Testing Custom CLI Verify edges (checking logic flows)...")
|
|
209
|
+
env["GABBE_AGENTS_DIR"] = str(custom_dir)
|
|
210
|
+
run_gabbe_command(f"{GABBE_EXEC} init", env, cwd)
|
|
211
|
+
run_gabbe_command(f"{GABBE_EXEC} sync", env, cwd)
|
|
212
|
+
verify_out = run_gabbe_command(f"{GABBE_EXEC} verify", env, cwd)
|
|
213
|
+
assert verify_out is not None
|
|
214
|
+
|
|
215
|
+
print("Testing Custom Update Flow...")
|
|
216
|
+
create_mock_user_files(custom_dir)
|
|
217
|
+
inputs_update = [
|
|
218
|
+
"3", # Custom
|
|
219
|
+
str(custom_dir),
|
|
220
|
+
"y", # Merge
|
|
221
|
+
"",
|
|
222
|
+
"",
|
|
223
|
+
"1",
|
|
224
|
+
"1",
|
|
225
|
+
"3",
|
|
226
|
+
"",
|
|
227
|
+
"6",
|
|
228
|
+
"7",
|
|
229
|
+
"n",
|
|
230
|
+
"n",
|
|
231
|
+
"n",
|
|
232
|
+
"n",
|
|
233
|
+
"7",
|
|
234
|
+
]
|
|
235
|
+
out_update = run_init(inputs_update, env, cwd)
|
|
236
|
+
verify_mock_user_files(custom_dir)
|
|
237
|
+
assert "Preserved user file(s): AGENTS.md" in out_update
|
|
238
|
+
print("[PASS] Custom flows safely tested.\n")
|
|
239
|
+
|
|
240
|
+
|
|
241
|
+
if __name__ == "__main__":
|
|
242
|
+
print("=== Starting E2E Setup Simulation Validations ===\n")
|
|
243
|
+
test_global_flow()
|
|
244
|
+
test_local_flow()
|
|
245
|
+
test_custom_flow()
|
|
246
|
+
print("\\033[0;32mALL COMPREHENSIVE E2E FLOWS (12 PERMUTATIONS) VERIFIED SUCCESSFULLY.\\033[0m")
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
import sys
|
|
4
|
+
import tempfile
|
|
5
|
+
from pathlib import Path
|
|
6
|
+
from unittest.mock import patch
|
|
7
|
+
|
|
8
|
+
# Add project root and scripts dir to path so we can import init
|
|
9
|
+
PROJECT_ROOT = Path(__file__).parent.parent.parent
|
|
10
|
+
sys.path.append(str(PROJECT_ROOT))
|
|
11
|
+
sys.path.append(str(PROJECT_ROOT / "scripts"))
|
|
12
|
+
|
|
13
|
+
import init # noqa: E402
|
|
14
|
+
|
|
15
|
+
RED = "\033[0;31m"
|
|
16
|
+
GREEN = "\033[0;32m"
|
|
17
|
+
NC = "\033[0m"
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
def test_tech_map_generation():
|
|
21
|
+
print("\nTesting build_tech_map_from_skills...")
|
|
22
|
+
# Point to the actual agents dir
|
|
23
|
+
agents_dir = PROJECT_ROOT / "agents"
|
|
24
|
+
tech_map = init.build_tech_map_from_skills(agents_dir)
|
|
25
|
+
|
|
26
|
+
# Assertions
|
|
27
|
+
if "python" in tech_map and "tdd-cycle" in tech_map["python"]["skills"]:
|
|
28
|
+
print(f"{GREEN}[PASS] Python mapped to tdd-cycle{NC}")
|
|
29
|
+
else:
|
|
30
|
+
print(f"{RED}[FAIL] Python mapping issues: {tech_map.get('python')}{NC}")
|
|
31
|
+
|
|
32
|
+
if "brain" in tech_map and "sequential-thinking" in tech_map["brain"]["skills"]:
|
|
33
|
+
print(f"{GREEN}[PASS] Brain mapped to sequential-thinking{NC}")
|
|
34
|
+
else:
|
|
35
|
+
# sequential-thinking tag is 'brain', 'core', 'reasoning'
|
|
36
|
+
# check if 'brain' key exists
|
|
37
|
+
print(f"{RED}[FAIL] Brain mapping issues.{NC}")
|
|
38
|
+
|
|
39
|
+
# Check if we have entries
|
|
40
|
+
print(f"Total keys in TECH_MAP: {len(tech_map)}")
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
def test_platform_setup():
|
|
44
|
+
print("\nTesting setup_skills_for_platform...")
|
|
45
|
+
with tempfile.TemporaryDirectory() as temp_dir_str:
|
|
46
|
+
temp_dir = Path(temp_dir_str)
|
|
47
|
+
# setup_skills_for_platform(platform, agents_dir, target_dir) expects the
|
|
48
|
+
# AGENTS directory (it looks for agents_dir/scripts/compile_skills.py and
|
|
49
|
+
# reads agents_dir/skills) — NOT the skills dir itself.
|
|
50
|
+
agents_dir = PROJECT_ROOT / "agents"
|
|
51
|
+
|
|
52
|
+
# Test Cursor (Generation). For Cursor the compiler writes only to
|
|
53
|
+
# target_dir (no project-root mutation), so a temp target is safe.
|
|
54
|
+
cursor_target = temp_dir / "cursor_rules"
|
|
55
|
+
init.setup_skills_for_platform("Cursor", agents_dir, cursor_target)
|
|
56
|
+
|
|
57
|
+
if cursor_target.exists() and list(cursor_target.glob("*.mdc")):
|
|
58
|
+
print(f"{GREEN}[PASS] Cursor rules generated{NC}")
|
|
59
|
+
# Check the real Cursor frontmatter contract emitted by compile_skills.py:
|
|
60
|
+
# description + `alwaysApply: false` (Agent-Requested rule, no globs).
|
|
61
|
+
mdc_files = list(cursor_target.glob("*.mdc"))
|
|
62
|
+
content = mdc_files[0].read_text()
|
|
63
|
+
if "alwaysApply: false" in content:
|
|
64
|
+
print(f"{GREEN}[PASS] Cursor frontmatter (alwaysApply: false) present{NC}")
|
|
65
|
+
else:
|
|
66
|
+
print(f"{RED}[FAIL] Cursor frontmatter missing alwaysApply: false{NC}")
|
|
67
|
+
else:
|
|
68
|
+
print(f"{RED}[FAIL] Cursor rules not generated{NC}")
|
|
69
|
+
|
|
70
|
+
|
|
71
|
+
def test_symlink_fallback():
|
|
72
|
+
print("\nTesting symlink fallback mechanism...")
|
|
73
|
+
with tempfile.TemporaryDirectory() as temp_dir_str:
|
|
74
|
+
temp_dir = Path(temp_dir_str)
|
|
75
|
+
source = temp_dir / "source"
|
|
76
|
+
source.mkdir()
|
|
77
|
+
(source / "file.txt").write_text("content")
|
|
78
|
+
target = temp_dir / "target"
|
|
79
|
+
|
|
80
|
+
# Mock os.symlink to raise OSError (simulate Windows non-admin)
|
|
81
|
+
with patch("os.symlink", side_effect=OSError("Privilege not held")):
|
|
82
|
+
# We need to import init inside patch context or patch where it's used
|
|
83
|
+
# Since we imported init at top level, we patch 'os.symlink' globally if possible,
|
|
84
|
+
# but better to patch 'init.os.symlink' if that's how it's bound, or just 'os.symlink'.
|
|
85
|
+
|
|
86
|
+
# Recalling create_symlink logic: it calls os.symlink
|
|
87
|
+
init.create_symlink(source, target)
|
|
88
|
+
|
|
89
|
+
if target.exists() and not target.is_symlink():
|
|
90
|
+
print(f"{GREEN}[PASS] Fallback copy successful (Target exists and is NOT symlink){NC}")
|
|
91
|
+
else:
|
|
92
|
+
print(
|
|
93
|
+
f"{RED}[FAIL] Fallback failed. Target exists: {target.exists()}, Is symlink: {target.is_symlink()}{NC}"
|
|
94
|
+
)
|
|
95
|
+
|
|
96
|
+
|
|
97
|
+
def main():
|
|
98
|
+
test_tech_map_generation()
|
|
99
|
+
test_platform_setup()
|
|
100
|
+
test_symlink_fallback()
|
|
101
|
+
|
|
102
|
+
|
|
103
|
+
if __name__ == "__main__":
|
|
104
|
+
main()
|
|
@@ -0,0 +1,159 @@
|
|
|
1
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
import json
|
|
3
|
+
import os
|
|
4
|
+
import re
|
|
5
|
+
import sys
|
|
6
|
+
from pathlib import Path
|
|
7
|
+
|
|
8
|
+
# ANSI colors for output
|
|
9
|
+
RED = "\033[0;31m"
|
|
10
|
+
GREEN = "\033[0;32m"
|
|
11
|
+
BLUE = "\033[0;34m"
|
|
12
|
+
YELLOW = "\033[0;33m"
|
|
13
|
+
NC = "\033[0m"
|
|
14
|
+
|
|
15
|
+
PROJECT_ROOT = Path(__file__).parent.parent.parent
|
|
16
|
+
AGENTS_DIR = PROJECT_ROOT / "agents"
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
def verify_triggers_and_mcps():
|
|
20
|
+
print(f"\n{BLUE}=== Skill Triggers and MCP Server Audit ==={NC}")
|
|
21
|
+
|
|
22
|
+
# 1. Parse MCP Servers
|
|
23
|
+
mcp_config_path = AGENTS_DIR / "templates/core/MCP_CONFIG_TEMPLATE.json"
|
|
24
|
+
with open(mcp_config_path, "r") as f:
|
|
25
|
+
mcp_data = json.load(f)
|
|
26
|
+
|
|
27
|
+
mcp_servers = set(mcp_data.get("mcpServers", {}).keys())
|
|
28
|
+
print(
|
|
29
|
+
f"{GREEN}✓ Loaded {len(mcp_servers)} MCP Servers from Config: {', '.join(list(mcp_servers)[:5])}...{NC}"
|
|
30
|
+
)
|
|
31
|
+
|
|
32
|
+
# 2. Parse 00-index.md to get Skill File -> Triggers map
|
|
33
|
+
skill_index_path = AGENTS_DIR / "skills/00-index.md"
|
|
34
|
+
|
|
35
|
+
skill_triggers = {}
|
|
36
|
+
all_triggers = set()
|
|
37
|
+
|
|
38
|
+
with open(skill_index_path, "r") as f:
|
|
39
|
+
for line in f:
|
|
40
|
+
if "|" in line and ".skill.md" in line:
|
|
41
|
+
# Format is usually: | Skill Name | `path/to/skill.skill.md` | trigger1, trigger2 | ... |
|
|
42
|
+
parts = [p.strip() for p in line.split("|")]
|
|
43
|
+
if len(parts) >= 4:
|
|
44
|
+
file_match = re.search(r"`([^`]+\.skill\.md)`", parts[2])
|
|
45
|
+
if file_match:
|
|
46
|
+
file_path = file_match.group(1)
|
|
47
|
+
basename = file_path.split("/")[-1].replace(".skill.md", "")
|
|
48
|
+
|
|
49
|
+
triggers = [t.strip() for t in parts[3].split(",")]
|
|
50
|
+
skill_triggers[basename] = triggers
|
|
51
|
+
all_triggers.update(triggers)
|
|
52
|
+
|
|
53
|
+
print(f"{GREEN}✓ Extracted triggers for {len(skill_triggers)} skills.{NC}")
|
|
54
|
+
|
|
55
|
+
# Check that Triggers aren't empty
|
|
56
|
+
empty_triggers = [s for s, t in skill_triggers.items() if not t or t == [""]]
|
|
57
|
+
if empty_triggers:
|
|
58
|
+
print(f"{RED}x FAIL: Skills with missing triggers in index: {empty_triggers}{NC}")
|
|
59
|
+
sys.exit(1)
|
|
60
|
+
|
|
61
|
+
# 3. Check Prompts in Docs
|
|
62
|
+
docs_to_check = [
|
|
63
|
+
PROJECT_ROOT / "README.md",
|
|
64
|
+
PROJECT_ROOT / "docs/README_FULL.md",
|
|
65
|
+
PROJECT_ROOT / "docs/QUICK_GUIDE.md",
|
|
66
|
+
PROJECT_ROOT / "docs/QUICK_COMMANDS.md",
|
|
67
|
+
]
|
|
68
|
+
|
|
69
|
+
for folder in ["guides", "skills"]:
|
|
70
|
+
folder_path = AGENTS_DIR / folder
|
|
71
|
+
if folder_path.exists():
|
|
72
|
+
for root, _, files in os.walk(folder_path):
|
|
73
|
+
for f in files:
|
|
74
|
+
if f.endswith(".md"):
|
|
75
|
+
docs_to_check.append(Path(root) / f)
|
|
76
|
+
|
|
77
|
+
print(f"\n{BLUE}--- Validating Prompt Chaining across {len(docs_to_check)} files ---{NC}")
|
|
78
|
+
|
|
79
|
+
# Regex to find: "run X skill" or "use X skill"
|
|
80
|
+
prompt_skill_regex = re.compile(
|
|
81
|
+
r"(?:use|run)\s+(?:the\s+)?([a-zA-Z0-9-]+)\s*skill", re.IGNORECASE
|
|
82
|
+
)
|
|
83
|
+
|
|
84
|
+
stop_words = {
|
|
85
|
+
"a",
|
|
86
|
+
"this",
|
|
87
|
+
"that",
|
|
88
|
+
"any",
|
|
89
|
+
"some",
|
|
90
|
+
"which",
|
|
91
|
+
"your",
|
|
92
|
+
"my",
|
|
93
|
+
"our",
|
|
94
|
+
"one",
|
|
95
|
+
"another",
|
|
96
|
+
"these",
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
errors = 0
|
|
100
|
+
warnings = 0
|
|
101
|
+
for doc in docs_to_check:
|
|
102
|
+
if not doc.exists():
|
|
103
|
+
continue
|
|
104
|
+
with open(doc, "r") as f:
|
|
105
|
+
content = f.read()
|
|
106
|
+
|
|
107
|
+
mentions = prompt_skill_regex.findall(content)
|
|
108
|
+
for mention in mentions:
|
|
109
|
+
mention = mention.lower()
|
|
110
|
+
if mention in stop_words:
|
|
111
|
+
continue
|
|
112
|
+
|
|
113
|
+
# If it explicitly matches a skill filename or a registered trigger
|
|
114
|
+
if mention in skill_triggers or mention in all_triggers:
|
|
115
|
+
pass # valid
|
|
116
|
+
else:
|
|
117
|
+
print(
|
|
118
|
+
f"{YELLOW}! WARNING: Document '{doc.name}' uses skill/trigger '{mention}' which is not in the index.{NC}"
|
|
119
|
+
)
|
|
120
|
+
warnings += 1
|
|
121
|
+
# We won't strictly fail on this because natural language might say "use debugging skill" instead of "use debug skill",
|
|
122
|
+
# but it's a good sanity check.
|
|
123
|
+
|
|
124
|
+
# 4. Check specific Visual Design MCPs bindings
|
|
125
|
+
visual_skill_path = AGENTS_DIR / "skills/architecture/visual-whiteboarding.skill.md"
|
|
126
|
+
if visual_skill_path.exists():
|
|
127
|
+
with open(visual_skill_path, "r") as f:
|
|
128
|
+
visual_content = f.read()
|
|
129
|
+
|
|
130
|
+
required_mcps = ["drawio", "miro", "figma"]
|
|
131
|
+
for rmcp in required_mcps:
|
|
132
|
+
# We must check if the tool actually documents these specifically mapping to the exact keys in MCP JSON.
|
|
133
|
+
mcp_key = None
|
|
134
|
+
for key in mcp_servers:
|
|
135
|
+
if rmcp.lower() in key.lower() or key.lower() in rmcp.lower():
|
|
136
|
+
mcp_key = key
|
|
137
|
+
break
|
|
138
|
+
|
|
139
|
+
if mcp_key:
|
|
140
|
+
print(
|
|
141
|
+
f"{GREEN}✓ Mapped '{rmcp}' capability in visual skill to MCP Server key: {mcp_key}{NC}"
|
|
142
|
+
)
|
|
143
|
+
else:
|
|
144
|
+
print(
|
|
145
|
+
f"{RED}x FAIL: Visual skill requires '{rmcp}' but no matching MCP Server found in MCP_CONFIG_TEMPLATE.json!{NC}"
|
|
146
|
+
)
|
|
147
|
+
errors += 1
|
|
148
|
+
|
|
149
|
+
if errors > 0:
|
|
150
|
+
print(f"\n{RED}Audit Failed with {errors} errors.{NC}")
|
|
151
|
+
sys.exit(1)
|
|
152
|
+
|
|
153
|
+
print(
|
|
154
|
+
f"\n{GREEN}=== Audit Complete. All triggers, skills, and MCP bindings are chained correctly. ==={NC}"
|
|
155
|
+
)
|
|
156
|
+
|
|
157
|
+
|
|
158
|
+
if __name__ == "__main__":
|
|
159
|
+
verify_triggers_and_mcps()
|