@zenrick/zenkit 0.0.0-stage → 0.5.1
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/.claude-plugin/marketplace.json +19 -0
- package/.cursor-plugin/marketplace.json +22 -0
- package/INSTALL.md +73 -0
- package/LICENSE +202 -0
- package/NOTICE +5 -0
- package/README.md +69 -3
- package/TERMS.md +48 -0
- package/THIRD-PARTY-NOTICES.md +109 -0
- package/kit/agents/backend-specialist.md +263 -0
- package/kit/agents/code-archaeologist.md +106 -0
- package/kit/agents/database-architect.md +226 -0
- package/kit/agents/debugger.md +226 -0
- package/kit/agents/devops-engineer.md +242 -0
- package/kit/agents/documentation-writer.md +104 -0
- package/kit/agents/explorer-agent.md +73 -0
- package/kit/agents/frontend-specialist.md +593 -0
- package/kit/agents/game-developer.md +162 -0
- package/kit/agents/mobile-developer.md +377 -0
- package/kit/agents/orchestrator.md +489 -0
- package/kit/agents/penetration-tester.md +188 -0
- package/kit/agents/performance-optimizer.md +187 -0
- package/kit/agents/product-manager.md +112 -0
- package/kit/agents/product-owner.md +95 -0
- package/kit/agents/project-planner.md +409 -0
- package/kit/agents/qa-automation-engineer.md +103 -0
- package/kit/agents/security-auditor.md +170 -0
- package/kit/agents/seo-specialist.md +111 -0
- package/kit/agents/test-engineer.md +158 -0
- package/kit/bundles/agent-building.yaml +26 -0
- package/kit/bundles/backend-data.yaml +14 -0
- package/kit/bundles/base.yaml +10 -0
- package/kit/bundles/core.yaml +21 -0
- package/kit/bundles/kit-engenharia.yaml +8 -0
- package/kit/bundles/kit-lite.yaml +9 -0
- package/kit/bundles/security.yaml +11 -0
- package/kit/bundles/ship-run.yaml +16 -0
- package/kit/bundles/web-ui.yaml +18 -0
- package/kit/commands/docs.md +33 -0
- package/kit/commands/explain.md +41 -0
- package/kit/commands/fix.md +65 -0
- package/kit/commands/implement.md +35 -0
- package/kit/commands/refactor.md +59 -0
- package/kit/commands/review.md +55 -0
- package/kit/commands/test.md +63 -0
- package/kit/modules/bridge/rules/cross-ide-bridge.mdc +73 -0
- package/kit/modules/bridge/zenkit-layer.yaml +1 -0
- package/kit/modules/nexuscore/sections/convivencia.md +12 -0
- package/kit/modules/nexuscore/sections/memoria.md +9 -0
- package/kit/modules/nexuscore/skills/quadro-agentes/SKILL.md +186 -0
- package/kit/modules/nexuscore/zenkit-layer.yaml +1 -0
- package/kit/rules/ZENKIT.mdc +294 -0
- package/kit/rules/git.mdc +51 -0
- package/kit/rules/karpathy-guidelines.mdc +70 -0
- package/kit/rules/model-routing.mdc +89 -0
- package/kit/rules/security-headers.mdc +41 -0
- package/kit/rules/social-automation.mdc +69 -0
- package/kit/rules/toc.mdc +40 -0
- package/kit/skills/api-patterns/SKILL.md +95 -0
- package/kit/skills/api-patterns/api-style.md +42 -0
- package/kit/skills/api-patterns/auth.md +24 -0
- package/kit/skills/api-patterns/documentation.md +26 -0
- package/kit/skills/api-patterns/graphql.md +41 -0
- package/kit/skills/api-patterns/rate-limiting.md +31 -0
- package/kit/skills/api-patterns/references/backend/backend-api-design.md +495 -0
- package/kit/skills/api-patterns/references/backend/backend-architecture.md +454 -0
- package/kit/skills/api-patterns/references/backend/backend-authentication.md +338 -0
- package/kit/skills/api-patterns/references/backend/backend-code-quality.md +659 -0
- package/kit/skills/api-patterns/references/backend/backend-debugging.md +904 -0
- package/kit/skills/api-patterns/references/backend/backend-devops.md +494 -0
- package/kit/skills/api-patterns/references/backend/backend-mindset.md +387 -0
- package/kit/skills/api-patterns/references/backend/backend-performance.md +397 -0
- package/kit/skills/api-patterns/references/backend/backend-security.md +290 -0
- package/kit/skills/api-patterns/references/backend/backend-technologies.md +256 -0
- package/kit/skills/api-patterns/references/backend/backend-testing.md +429 -0
- package/kit/skills/api-patterns/response.md +37 -0
- package/kit/skills/api-patterns/rest.md +40 -0
- package/kit/skills/api-patterns/scripts/api_validator.py +211 -0
- package/kit/skills/api-patterns/security-testing.md +122 -0
- package/kit/skills/api-patterns/trpc.md +41 -0
- package/kit/skills/api-patterns/versioning.md +22 -0
- package/kit/skills/app-builder/SKILL.md +76 -0
- package/kit/skills/app-builder/agent-coordination.md +71 -0
- package/kit/skills/app-builder/feature-building.md +53 -0
- package/kit/skills/app-builder/project-detection.md +34 -0
- package/kit/skills/app-builder/scaffolding.md +118 -0
- package/kit/skills/app-builder/tech-stack.md +41 -0
- package/kit/skills/app-builder/templates/SKILL.md +39 -0
- package/kit/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
- package/kit/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
- package/kit/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
- package/kit/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
- package/kit/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
- package/kit/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
- package/kit/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
- package/kit/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +122 -0
- package/kit/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +122 -0
- package/kit/skills/app-builder/templates/nextjs-static/TEMPLATE.md +169 -0
- package/kit/skills/app-builder/templates/nuxt-app/TEMPLATE.md +134 -0
- package/kit/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
- package/kit/skills/app-builder/templates/react-native-app/TEMPLATE.md +119 -0
- package/kit/skills/architecture/SKILL.md +56 -0
- package/kit/skills/architecture/context-discovery.md +43 -0
- package/kit/skills/architecture/examples.md +94 -0
- package/kit/skills/architecture/pattern-selection.md +68 -0
- package/kit/skills/architecture/patterns-reference.md +50 -0
- package/kit/skills/architecture/trade-off-analysis.md +77 -0
- package/kit/skills/bash-linux/SKILL.md +203 -0
- package/kit/skills/batch-operations/SKILL.md +112 -0
- package/kit/skills/behavioral-modes/SKILL.md +255 -0
- package/kit/skills/brainstorming/SKILL.md +189 -0
- package/kit/skills/brainstorming/dynamic-questioning.md +350 -0
- package/kit/skills/brainstorming/references/problem-solving/attribution.md +69 -0
- package/kit/skills/brainstorming/references/problem-solving/collision-zone-thinking.md +79 -0
- package/kit/skills/brainstorming/references/problem-solving/inversion-exercise.md +91 -0
- package/kit/skills/brainstorming/references/problem-solving/meta-pattern-recognition.md +87 -0
- package/kit/skills/brainstorming/references/problem-solving/scale-game.md +95 -0
- package/kit/skills/brainstorming/references/problem-solving/simplification-cascades.md +80 -0
- package/kit/skills/brainstorming/references/problem-solving/when-stuck.md +72 -0
- package/kit/skills/claude-exec/SKILL.md +185 -0
- package/kit/skills/clean-code/SKILL.md +210 -0
- package/kit/skills/code-review-checklist/SKILL.md +115 -0
- package/kit/skills/code-review-graph/SKILL.md +50 -0
- package/kit/skills/code-review-graph/references/alternatives-comparison.md +12 -0
- package/kit/skills/code-review-graph/references/best-practices.md +9 -0
- package/kit/skills/code-review-graph/references/configuration.md +43 -0
- package/kit/skills/code-review-graph/references/core-workflows.md +61 -0
- package/kit/skills/code-review-graph/references/how-it-works-4-layers.md +20 -0
- package/kit/skills/code-review-graph/references/installation.md +67 -0
- package/kit/skills/code-review-graph/references/integration-with-zenkit.md +23 -0
- package/kit/skills/code-review-graph/references/known-limitations.md +13 -0
- package/kit/skills/code-review-graph/references/when-to-use-vs-when-to-skip.md +21 -0
- package/kit/skills/codex-exec/SKILL.md +161 -0
- package/kit/skills/context-compression/SKILL.md +145 -0
- package/kit/skills/coordinator-mode/SKILL.md +215 -0
- package/kit/skills/cursor-exec/SKILL.md +152 -0
- package/kit/skills/database-design/SKILL.md +53 -0
- package/kit/skills/database-design/database-selection.md +43 -0
- package/kit/skills/database-design/indexing.md +39 -0
- package/kit/skills/database-design/migrations.md +48 -0
- package/kit/skills/database-design/optimization.md +36 -0
- package/kit/skills/database-design/orm-selection.md +30 -0
- package/kit/skills/database-design/schema-design.md +56 -0
- package/kit/skills/database-design/scripts/schema_validator.py +172 -0
- package/kit/skills/deployment-procedures/SKILL.md +242 -0
- package/kit/skills/deprecation-and-migration/SKILL.md +149 -0
- package/kit/skills/documentation-templates/SKILL.md +195 -0
- package/kit/skills/entrega-com-agentes/SKILL.md +177 -0
- package/kit/skills/frontend-design/NOTICE.md +6 -0
- package/kit/skills/frontend-design/SKILL.md +456 -0
- package/kit/skills/frontend-design/animation-guide.md +331 -0
- package/kit/skills/frontend-design/color-system.md +311 -0
- package/kit/skills/frontend-design/decision-trees.md +418 -0
- package/kit/skills/frontend-design/motion-graphics.md +306 -0
- package/kit/skills/frontend-design/references/aesthetic/design-guideline-template.md +163 -0
- package/kit/skills/frontend-design/references/aesthetic/design-principles.md +62 -0
- package/kit/skills/frontend-design/references/aesthetic/design-resources.md +75 -0
- package/kit/skills/frontend-design/references/aesthetic/design-story-template.md +135 -0
- package/kit/skills/frontend-design/references/aesthetic/micro-interactions.md +53 -0
- package/kit/skills/frontend-design/references/aesthetic/storytelling-design.md +50 -0
- package/kit/skills/frontend-design/scripts/accessibility_checker.py +183 -0
- package/kit/skills/frontend-design/scripts/ux_audit.py +722 -0
- package/kit/skills/frontend-design/typography-system.md +345 -0
- package/kit/skills/frontend-design/ux-psychology.md +1116 -0
- package/kit/skills/frontend-design/visual-effects.md +383 -0
- package/kit/skills/game-development/2d-games/SKILL.md +119 -0
- package/kit/skills/game-development/3d-games/SKILL.md +135 -0
- package/kit/skills/game-development/SKILL.md +168 -0
- package/kit/skills/game-development/game-art/SKILL.md +185 -0
- package/kit/skills/game-development/game-audio/SKILL.md +190 -0
- package/kit/skills/game-development/game-design/SKILL.md +129 -0
- package/kit/skills/game-development/mobile-games/SKILL.md +108 -0
- package/kit/skills/game-development/multiplayer/SKILL.md +132 -0
- package/kit/skills/game-development/pc-games/SKILL.md +144 -0
- package/kit/skills/game-development/vr-ar/SKILL.md +123 -0
- package/kit/skills/game-development/web-games/SKILL.md +150 -0
- package/kit/skills/gemini-exec/SKILL.md +80 -0
- package/kit/skills/geo-fundamentals/SKILL.md +157 -0
- package/kit/skills/geo-fundamentals/scripts/geo_checker.py +289 -0
- package/kit/skills/git-worktrees/SKILL.md +107 -0
- package/kit/skills/i18n-localization/SKILL.md +145 -0
- package/kit/skills/i18n-localization/scripts/i18n_checker.py +241 -0
- package/kit/skills/intelligent-routing/SKILL.md +128 -0
- package/kit/skills/intelligent-routing/references/4-response-format.md +16 -0
- package/kit/skills/intelligent-routing/references/complexity-assessment.md +29 -0
- package/kit/skills/intelligent-routing/references/debug-intelligent-routing.md +9 -0
- package/kit/skills/intelligent-routing/references/debugging-agent-selection.md +7 -0
- package/kit/skills/intelligent-routing/references/domain-detection-rules.md +29 -0
- package/kit/skills/intelligent-routing/references/edge-cases.md +29 -0
- package/kit/skills/intelligent-routing/references/implementation-rules.md +35 -0
- package/kit/skills/intelligent-routing/references/integration-with-existing-workflows.md +21 -0
- package/kit/skills/intelligent-routing/references/performance-considerations.md +14 -0
- package/kit/skills/intelligent-routing/references/summary.md +16 -0
- package/kit/skills/intelligent-routing/references/testing-the-system.md +36 -0
- package/kit/skills/intelligent-routing/references/tier-0-automatic-analysis-always-active.md +27 -0
- package/kit/skills/intelligent-routing/references/user-education.md +12 -0
- package/kit/skills/karpathy-guidelines/SKILL.md +67 -0
- package/kit/skills/karpathy-guidelines/references/EXAMPLES.md +522 -0
- package/kit/skills/lint-and-validate/SKILL.md +46 -0
- package/kit/skills/lint-and-validate/scripts/lint_runner.py +184 -0
- package/kit/skills/lint-and-validate/scripts/type_coverage.py +173 -0
- package/kit/skills/mcp-atuacao/SKILL.md +238 -0
- package/kit/skills/mcp-builder/NOTICE.md +6 -0
- package/kit/skills/mcp-builder/SKILL.md +259 -0
- package/kit/skills/memory-system/SKILL.md +181 -0
- package/kit/skills/mobile-design/SKILL.md +395 -0
- package/kit/skills/mobile-design/decision-trees.md +516 -0
- package/kit/skills/mobile-design/mobile-backend.md +491 -0
- package/kit/skills/mobile-design/mobile-color-system.md +420 -0
- package/kit/skills/mobile-design/mobile-debugging.md +122 -0
- package/kit/skills/mobile-design/mobile-design-thinking.md +357 -0
- package/kit/skills/mobile-design/mobile-navigation.md +458 -0
- package/kit/skills/mobile-design/mobile-performance.md +767 -0
- package/kit/skills/mobile-design/mobile-testing.md +356 -0
- package/kit/skills/mobile-design/mobile-typography.md +433 -0
- package/kit/skills/mobile-design/platform-android.md +666 -0
- package/kit/skills/mobile-design/platform-ios.md +561 -0
- package/kit/skills/mobile-design/scripts/mobile_audit.py +670 -0
- package/kit/skills/mobile-design/touch-psychology.md +537 -0
- package/kit/skills/negocio-agente-conversa/SKILL.md +168 -0
- package/kit/skills/negocio-atendimento/SKILL.md +134 -0
- package/kit/skills/negocio-linguagem/SKILL.md +166 -0
- package/kit/skills/negocio-preco/SKILL.md +174 -0
- package/kit/skills/negocio-preco/scripts/preco.mjs +160 -0
- package/kit/skills/negocio-qualificacao/SKILL.md +140 -0
- package/kit/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +351 -0
- package/kit/skills/nextjs-react-expert/2-bundle-bundle-size-optimization.md +240 -0
- package/kit/skills/nextjs-react-expert/3-server-server-side-performance.md +490 -0
- package/kit/skills/nextjs-react-expert/4-client-client-side-data-fetching.md +264 -0
- package/kit/skills/nextjs-react-expert/5-rerender-re-render-optimization.md +581 -0
- package/kit/skills/nextjs-react-expert/6-rendering-rendering-performance.md +432 -0
- package/kit/skills/nextjs-react-expert/7-js-javascript-performance.md +684 -0
- package/kit/skills/nextjs-react-expert/8-advanced-advanced-patterns.md +150 -0
- package/kit/skills/nextjs-react-expert/9-cache-components.md +103 -0
- package/kit/skills/nextjs-react-expert/SKILL.md +308 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/common-patterns.md +331 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/complete-examples.md +872 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/component-patterns.md +502 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/data-fetching.md +767 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/file-organization.md +502 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/loading-and-error-states.md +501 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/performance.md +406 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/routing-guide.md +364 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/styling-guide.md +428 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/typescript-standards.md +418 -0
- package/kit/skills/nextjs-react-expert/scripts/convert_rules.py +222 -0
- package/kit/skills/nextjs-react-expert/scripts/react_performance_checker.py +252 -0
- package/kit/skills/nodejs-best-practices/SKILL.md +78 -0
- package/kit/skills/nodejs-best-practices/references/10-anti-patterns-to-avoid.md +21 -0
- package/kit/skills/nodejs-best-practices/references/11-decision-checklist.md +14 -0
- package/kit/skills/nodejs-best-practices/references/2-runtime-considerations-2025.md +36 -0
- package/kit/skills/nodejs-best-practices/references/3-architecture-principles.md +35 -0
- package/kit/skills/nodejs-best-practices/references/4-error-handling-principles.md +42 -0
- package/kit/skills/nodejs-best-practices/references/5-async-patterns-principles.md +35 -0
- package/kit/skills/nodejs-best-practices/references/6-validation-principles.md +29 -0
- package/kit/skills/nodejs-best-practices/references/7-security-principles.md +29 -0
- package/kit/skills/nodejs-best-practices/references/8-testing-principles.md +28 -0
- package/kit/skills/observability-and-instrumentation/SKILL.md +150 -0
- package/kit/skills/opencode-go-exec/SKILL.md +101 -0
- package/kit/skills/parallel-agents/SKILL.md +184 -0
- package/kit/skills/performance-profiling/SKILL.md +145 -0
- package/kit/skills/performance-profiling/scripts/lighthouse_audit.py +76 -0
- package/kit/skills/plan-writing/SKILL.md +213 -0
- package/kit/skills/powershell-windows/SKILL.md +196 -0
- package/kit/skills/provider-orchestration/SKILL.md +269 -0
- package/kit/skills/python-patterns/SKILL.md +80 -0
- package/kit/skills/python-patterns/references/10-decision-checklist.md +14 -0
- package/kit/skills/python-patterns/references/11-anti-patterns-to-avoid.md +20 -0
- package/kit/skills/python-patterns/references/2-async-vs-sync-decision.md +44 -0
- package/kit/skills/python-patterns/references/3-type-hints-strategy.md +56 -0
- package/kit/skills/python-patterns/references/4-project-structure-principles.md +56 -0
- package/kit/skills/python-patterns/references/5-django-principles-2025.md +40 -0
- package/kit/skills/python-patterns/references/6-fastapi-principles.md +50 -0
- package/kit/skills/python-patterns/references/7-background-tasks.md +31 -0
- package/kit/skills/python-patterns/references/8-error-handling-principles.md +29 -0
- package/kit/skills/python-patterns/references/9-testing-principles.md +37 -0
- package/kit/skills/red-team-tactics/SKILL.md +201 -0
- package/kit/skills/research/SKILL.md +166 -0
- package/kit/skills/rust-pro/SKILL.md +177 -0
- package/kit/skills/seo-fundamentals/SKILL.md +130 -0
- package/kit/skills/seo-fundamentals/scripts/seo_checker.py +219 -0
- package/kit/skills/sequential-thinking/.env.example +8 -0
- package/kit/skills/sequential-thinking/README.md +183 -0
- package/kit/skills/sequential-thinking/SKILL.md +95 -0
- package/kit/skills/sequential-thinking/package.json +31 -0
- package/kit/skills/sequential-thinking/references/advanced-strategies.md +79 -0
- package/kit/skills/sequential-thinking/references/advanced-techniques.md +76 -0
- package/kit/skills/sequential-thinking/references/core-patterns.md +95 -0
- package/kit/skills/sequential-thinking/references/examples-api.md +88 -0
- package/kit/skills/sequential-thinking/references/examples-architecture.md +94 -0
- package/kit/skills/sequential-thinking/references/examples-debug.md +90 -0
- package/kit/skills/sequential-thinking/scripts/format-thought.js +159 -0
- package/kit/skills/sequential-thinking/scripts/process-thought.js +236 -0
- package/kit/skills/server-management/SKILL.md +162 -0
- package/kit/skills/simplify-code/SKILL.md +133 -0
- package/kit/skills/skillify/SKILL.md +116 -0
- package/kit/skills/system-design-interview/SKILL.md +268 -0
- package/kit/skills/systematic-debugging/SKILL.md +110 -0
- package/kit/skills/tailwind-patterns/SKILL.md +283 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/canvas-design-system.md +320 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-accessibility.md +471 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-components.md +424 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-theming.md +373 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-customization.md +483 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-responsive.md +382 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-utilities.md +455 -0
- package/kit/skills/tdd-workflow/SKILL.md +150 -0
- package/kit/skills/testing-patterns/SKILL.md +196 -0
- package/kit/skills/testing-patterns/scripts/test_runner.py +219 -0
- package/kit/skills/ui-ux-pro-max/SKILL.md +135 -0
- package/kit/skills/verify-changes/SKILL.md +125 -0
- package/kit/skills/vulnerability-scanner/SKILL.md +278 -0
- package/kit/skills/vulnerability-scanner/checklists.md +121 -0
- package/kit/skills/vulnerability-scanner/scripts/security_scan.py +458 -0
- package/kit/skills/web-design-guidelines/SKILL.md +58 -0
- package/kit/skills/webapp-testing/NOTICE.md +6 -0
- package/kit/skills/webapp-testing/SKILL.md +188 -0
- package/kit/skills/webapp-testing/scripts/playwright_runner.py +173 -0
- package/kit/workflows/brainstorm.md +113 -0
- package/kit/workflows/coordinate.md +72 -0
- package/kit/workflows/create.md +59 -0
- package/kit/workflows/debug.md +103 -0
- package/kit/workflows/deploy.md +176 -0
- package/kit/workflows/enhance.md +63 -0
- package/kit/workflows/orchestrate.md +237 -0
- package/kit/workflows/plan.md +89 -0
- package/kit/workflows/preview.md +81 -0
- package/kit/workflows/remember.md +67 -0
- package/kit/workflows/status.md +86 -0
- package/kit/workflows/test.md +144 -0
- package/kit/workflows/ui-ux-pro-max.md +296 -0
- package/kit/workflows/verify.md +72 -0
- package/licenses/Apache-2.0.txt +202 -0
- package/package.json +60 -6
- package/scripts/archive-codex-rollouts.ps1 +35 -0
- package/scripts/avaliar-vigilancia-mandato.mjs +38 -0
- package/scripts/bundle.mjs +170 -0
- package/scripts/check-deps.mjs +178 -0
- package/scripts/check-models.mjs +150 -0
- package/scripts/cli.mjs +313 -0
- package/scripts/content-checks.mjs +18 -0
- package/scripts/continuidade-mandato.mjs +47 -0
- package/scripts/discriminar-turno.mjs +191 -0
- package/scripts/doctor.mjs +611 -0
- package/scripts/generate.mjs +688 -0
- package/scripts/install.mjs +11 -0
- package/scripts/layer-remote.mjs +407 -0
- package/scripts/layers.mjs +208 -0
- package/scripts/marketplace.mjs +77 -0
- package/scripts/product.mjs +32 -0
- package/scripts/ruleset-core.mjs +68 -0
- package/scripts/social-hooks.mjs +293 -0
- package/scripts/social-pacer.mjs +219 -0
- package/scripts/validate-bundles.mjs +14 -0
- package/scripts/validate-skills.mjs +174 -0
- package/scripts/zenkit-daemon-task.cmd +3 -0
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Identidade do produto no disco — um lugar só para nome de plugin, autor e versão.
|
|
3
|
+
* Manifestos Claude/Cursor e o CLI leem daqui. Não duplicar string de marca.
|
|
4
|
+
*/
|
|
5
|
+
import { promises as fs } from "node:fs";
|
|
6
|
+
import path from "node:path";
|
|
7
|
+
import { fileURLToPath } from "node:url";
|
|
8
|
+
|
|
9
|
+
export const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
|
|
10
|
+
export const AUTHOR = { name: "Zenrick" };
|
|
11
|
+
export const MARKETPLACE_NAME = "zenkit";
|
|
12
|
+
export const AGENT_PLUGIN_SCHEMA =
|
|
13
|
+
"https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
|
|
14
|
+
|
|
15
|
+
/** kit-lite → zenkit-lite. Bundle que não começa com kit- vira zenkit-<nome>. */
|
|
16
|
+
export function pluginId(bundleName) {
|
|
17
|
+
const stem = bundleName.startsWith("kit-")
|
|
18
|
+
? bundleName.slice("kit-".length)
|
|
19
|
+
: bundleName;
|
|
20
|
+
return `zenkit-${stem}`;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export async function kitVersion() {
|
|
24
|
+
const raw = await fs.readFile(path.join(ROOT, "package.json"), "utf8");
|
|
25
|
+
return JSON.parse(raw).version;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export function storefrontBundles(byName) {
|
|
29
|
+
return [...byName.values()]
|
|
30
|
+
.filter((b) => b.kind === "storefront")
|
|
31
|
+
.sort((a, b) => a.name.localeCompare(b.name));
|
|
32
|
+
}
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Always-on core of the NexusCore global ruleset (DEM-ZEN-PER-22).
|
|
3
|
+
*
|
|
4
|
+
* The full ruleset (~32 KB, ~9k tokens) used to ride in ~/.claude/CLAUDE.md and
|
|
5
|
+
* ~/.codex/AGENTS.md, i.e. in every turn of every session. Only the sections an
|
|
6
|
+
* agent needs on every turn stay inline; every other section is listed by title
|
|
7
|
+
* with a pointer to the canonical copy in NexusCore, so no rule disappears.
|
|
8
|
+
*
|
|
9
|
+
* Selection is by heading-title prefix. A kept heading carries its body until the
|
|
10
|
+
* next heading of the same or higher level. If any expected heading is missing
|
|
11
|
+
* (the source was renamed or restructured), the caller gets `null` and must fall
|
|
12
|
+
* back to the full text: losing a rule silently is worse than a bigger file.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
export const RULESET_CORE_HEADINGS = Object.freeze([
|
|
16
|
+
"Precedência",
|
|
17
|
+
"Proporcionalidade",
|
|
18
|
+
"8. Segurança",
|
|
19
|
+
"9. Privacidade",
|
|
20
|
+
"13. Code Review",
|
|
21
|
+
"Regras",
|
|
22
|
+
"Contrato de sessão MCP",
|
|
23
|
+
"Proveniência por provider",
|
|
24
|
+
]);
|
|
25
|
+
|
|
26
|
+
const HEADING = /^(#{2,4}) (.+?)\s*$/gm;
|
|
27
|
+
|
|
28
|
+
function parseHeadings(text) {
|
|
29
|
+
const heads = [];
|
|
30
|
+
for (const m of text.matchAll(HEADING)) {
|
|
31
|
+
heads.push({ level: m[1].length, title: m[2], start: m.index });
|
|
32
|
+
}
|
|
33
|
+
for (let i = 0; i < heads.length; i++) {
|
|
34
|
+
const next = heads.slice(i + 1).find((h) => h.level <= heads[i].level);
|
|
35
|
+
heads[i].end = next ? next.start : text.length;
|
|
36
|
+
}
|
|
37
|
+
return heads;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* @param {string} source full ruleset markdown
|
|
42
|
+
* @param {readonly string[]} keep heading-title prefixes to keep inline
|
|
43
|
+
* @returns {string | null} core markdown, or null when a kept heading is missing
|
|
44
|
+
*/
|
|
45
|
+
export function extractRulesetCore(source, keep = RULESET_CORE_HEADINGS) {
|
|
46
|
+
const heads = parseHeadings(source);
|
|
47
|
+
const kept = [];
|
|
48
|
+
for (const prefix of keep) {
|
|
49
|
+
const head = heads.find((h) => h.title.startsWith(prefix));
|
|
50
|
+
if (!head) return null;
|
|
51
|
+
kept.push(head);
|
|
52
|
+
}
|
|
53
|
+
kept.sort((a, b) => a.start - b.start);
|
|
54
|
+
|
|
55
|
+
const inKept = (h) => kept.some((k) => h.start >= k.start && h.start < k.end);
|
|
56
|
+
const hasKeptChild = (h) => kept.some((k) => k.start > h.start && k.start < h.end);
|
|
57
|
+
const omitted = heads
|
|
58
|
+
.filter((h) => h.level === 3 && !inKept(h))
|
|
59
|
+
.map((h) => (hasKeptChild(h) ? `${h.title} (parcial: o essencial está acima)` : h.title));
|
|
60
|
+
|
|
61
|
+
const body = kept.map((h) => source.slice(h.start, h.end).trimEnd()).join("\n\n");
|
|
62
|
+
const pointer =
|
|
63
|
+
"### Demais seções (fora do contexto de todo turno)\n\n" +
|
|
64
|
+
"Continuam valendo. Texto completo no NexusCore: `agents/ruleset` " +
|
|
65
|
+
"(ou `agents/rule/<n>`), via `search_memory`. Consulte antes de agir no tema:\n\n" +
|
|
66
|
+
omitted.map((t) => `- ${t}`).join("\n");
|
|
67
|
+
return `${body}\n\n${pointer}\n`;
|
|
68
|
+
}
|
|
@@ -0,0 +1,293 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* Idempotent installer/verifier for the social-pacer pre-shell guard.
|
|
4
|
+
*
|
|
5
|
+
* Wires:
|
|
6
|
+
* - Claude Code ~/.claude/settings.json → hooks.PreToolUse (matcher Bash)
|
|
7
|
+
* - Cursor ~/.cursor/hooks.json → hooks.beforeShellExecution
|
|
8
|
+
*
|
|
9
|
+
* Usage: node scripts/social-hooks.mjs <install|status|uninstall>
|
|
10
|
+
*/
|
|
11
|
+
import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
|
|
12
|
+
import { dirname, join } from "node:path";
|
|
13
|
+
import { homedir } from "node:os";
|
|
14
|
+
import { fileURLToPath } from "node:url";
|
|
15
|
+
|
|
16
|
+
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
17
|
+
const PACER = join(__dirname, "social-pacer.mjs");
|
|
18
|
+
const HOOK_CMD = `node "${PACER}" hook`;
|
|
19
|
+
const MARKER = "social-pacer.mjs";
|
|
20
|
+
|
|
21
|
+
const CLAUDE_SETTINGS = join(homedir(), ".claude", "settings.json");
|
|
22
|
+
const CURSOR_HOOKS = join(homedir(), ".cursor", "hooks.json");
|
|
23
|
+
const ANTIGRAVITY_HOOKS = join(homedir(), ".gemini", "config", "hooks.json");
|
|
24
|
+
const AGY_HOOK_CMD = `node ${PACER.replace(/\\/g, "/")} hook`;
|
|
25
|
+
|
|
26
|
+
function readJsonTolerant(path) {
|
|
27
|
+
if (!existsSync(path)) return {};
|
|
28
|
+
try {
|
|
29
|
+
const raw = readFileSync(path, "utf8").trim();
|
|
30
|
+
if (!raw) return {};
|
|
31
|
+
const parsed = JSON.parse(raw);
|
|
32
|
+
return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
|
|
33
|
+
} catch {
|
|
34
|
+
return {};
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
function writeJson(path, data) {
|
|
39
|
+
mkdirSync(dirname(path), { recursive: true });
|
|
40
|
+
writeFileSync(path, `${JSON.stringify(data, null, 2)}\n`, "utf8");
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
function topKeys(obj) {
|
|
44
|
+
return Object.keys(obj ?? {});
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
function audit(label, before, after) {
|
|
48
|
+
const b = new Set(topKeys(before));
|
|
49
|
+
const a = new Set(topKeys(after));
|
|
50
|
+
const added = [...a].filter((k) => !b.has(k));
|
|
51
|
+
const removed = [...b].filter((k) => !a.has(k));
|
|
52
|
+
const kept = [...b].filter((k) => a.has(k));
|
|
53
|
+
console.log(`${label}: keys before=[${[...b].join(", ") || "(none)"}] after=[${[...a].join(", ") || "(none)"}]`);
|
|
54
|
+
if (added.length) console.log(` + added: ${added.join(", ")}`);
|
|
55
|
+
if (removed.length) console.log(` - removed: ${removed.join(", ")}`);
|
|
56
|
+
if (!added.length && !removed.length) console.log(` ~ preserved: ${kept.join(", ") || "(none)"}`);
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
function isOurClaudeEntry(entry) {
|
|
60
|
+
const hooks = Array.isArray(entry?.hooks) ? entry.hooks : [];
|
|
61
|
+
return hooks.some((h) => typeof h?.command === "string" && h.command.includes(MARKER));
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
function isOurCursorEntry(entry) {
|
|
65
|
+
return typeof entry?.command === "string" && entry.command.includes(MARKER);
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
function claudeEntry() {
|
|
69
|
+
return {
|
|
70
|
+
matcher: "Bash",
|
|
71
|
+
hooks: [{ type: "command", command: HOOK_CMD }],
|
|
72
|
+
};
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
function cursorEntry() {
|
|
76
|
+
return { command: HOOK_CMD };
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
function installClaude() {
|
|
80
|
+
const before = readJsonTolerant(CLAUDE_SETTINGS);
|
|
81
|
+
// Preserve key order: mutate a shallow copy built from existing keys first.
|
|
82
|
+
const after = { ...before };
|
|
83
|
+
const hooks = after.hooks && typeof after.hooks === "object" && !Array.isArray(after.hooks)
|
|
84
|
+
? { ...after.hooks }
|
|
85
|
+
: {};
|
|
86
|
+
const pre = Array.isArray(hooks.PreToolUse) ? [...hooks.PreToolUse] : [];
|
|
87
|
+
const idx = pre.findIndex(isOurClaudeEntry);
|
|
88
|
+
if (idx >= 0) {
|
|
89
|
+
pre[idx] = claudeEntry();
|
|
90
|
+
console.log(`claude: updated existing PreToolUse entry → ${HOOK_CMD}`);
|
|
91
|
+
} else {
|
|
92
|
+
pre.push(claudeEntry());
|
|
93
|
+
console.log(`claude: added PreToolUse entry → ${HOOK_CMD}`);
|
|
94
|
+
}
|
|
95
|
+
hooks.PreToolUse = pre;
|
|
96
|
+
after.hooks = hooks;
|
|
97
|
+
writeJson(CLAUDE_SETTINGS, after);
|
|
98
|
+
audit("claude", before, after);
|
|
99
|
+
return after;
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
function uninstallClaude() {
|
|
103
|
+
const before = readJsonTolerant(CLAUDE_SETTINGS);
|
|
104
|
+
if (!existsSync(CLAUDE_SETTINGS) && !before.hooks) {
|
|
105
|
+
console.log("claude: nothing to uninstall");
|
|
106
|
+
audit("claude", before, before);
|
|
107
|
+
return before;
|
|
108
|
+
}
|
|
109
|
+
const after = { ...before };
|
|
110
|
+
if (!after.hooks || typeof after.hooks !== "object" || Array.isArray(after.hooks)) {
|
|
111
|
+
console.log("claude: no hooks key");
|
|
112
|
+
audit("claude", before, after);
|
|
113
|
+
return after;
|
|
114
|
+
}
|
|
115
|
+
const hooks = { ...after.hooks };
|
|
116
|
+
const pre = Array.isArray(hooks.PreToolUse) ? hooks.PreToolUse : [];
|
|
117
|
+
const next = pre.filter((e) => !isOurClaudeEntry(e));
|
|
118
|
+
const removedCount = pre.length - next.length;
|
|
119
|
+
if (removedCount === 0) {
|
|
120
|
+
console.log("claude: our entry not present");
|
|
121
|
+
} else {
|
|
122
|
+
console.log(`claude: removed ${removedCount} PreToolUse entr${removedCount === 1 ? "y" : "ies"}`);
|
|
123
|
+
}
|
|
124
|
+
if (next.length) hooks.PreToolUse = next;
|
|
125
|
+
else delete hooks.PreToolUse;
|
|
126
|
+
if (Object.keys(hooks).length) after.hooks = hooks;
|
|
127
|
+
else delete after.hooks;
|
|
128
|
+
writeJson(CLAUDE_SETTINGS, after);
|
|
129
|
+
audit("claude", before, after);
|
|
130
|
+
return after;
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
function installCursor() {
|
|
134
|
+
const before = readJsonTolerant(CURSOR_HOOKS);
|
|
135
|
+
const after = { ...before };
|
|
136
|
+
if (after.version == null) after.version = 1;
|
|
137
|
+
const hooks = after.hooks && typeof after.hooks === "object" && !Array.isArray(after.hooks)
|
|
138
|
+
? { ...after.hooks }
|
|
139
|
+
: {};
|
|
140
|
+
const list = Array.isArray(hooks.beforeShellExecution) ? [...hooks.beforeShellExecution] : [];
|
|
141
|
+
const idx = list.findIndex(isOurCursorEntry);
|
|
142
|
+
if (idx >= 0) {
|
|
143
|
+
list[idx] = cursorEntry();
|
|
144
|
+
console.log(`cursor: updated existing beforeShellExecution entry → ${HOOK_CMD}`);
|
|
145
|
+
} else {
|
|
146
|
+
list.push(cursorEntry());
|
|
147
|
+
console.log(`cursor: added beforeShellExecution entry → ${HOOK_CMD}`);
|
|
148
|
+
}
|
|
149
|
+
hooks.beforeShellExecution = list;
|
|
150
|
+
after.hooks = hooks;
|
|
151
|
+
writeJson(CURSOR_HOOKS, after);
|
|
152
|
+
audit("cursor", before, after);
|
|
153
|
+
return after;
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
function uninstallCursor() {
|
|
157
|
+
const before = readJsonTolerant(CURSOR_HOOKS);
|
|
158
|
+
if (!existsSync(CURSOR_HOOKS) && !before.hooks) {
|
|
159
|
+
console.log("cursor: nothing to uninstall");
|
|
160
|
+
audit("cursor", before, before);
|
|
161
|
+
return before;
|
|
162
|
+
}
|
|
163
|
+
const after = { ...before };
|
|
164
|
+
if (!after.hooks || typeof after.hooks !== "object" || Array.isArray(after.hooks)) {
|
|
165
|
+
console.log("cursor: no hooks key");
|
|
166
|
+
audit("cursor", before, after);
|
|
167
|
+
return after;
|
|
168
|
+
}
|
|
169
|
+
const hooks = { ...after.hooks };
|
|
170
|
+
const list = Array.isArray(hooks.beforeShellExecution) ? hooks.beforeShellExecution : [];
|
|
171
|
+
const next = list.filter((e) => !isOurCursorEntry(e));
|
|
172
|
+
const removedCount = list.length - next.length;
|
|
173
|
+
if (removedCount === 0) console.log("cursor: our entry not present");
|
|
174
|
+
else console.log(`cursor: removed ${removedCount} beforeShellExecution entr${removedCount === 1 ? "y" : "ies"}`);
|
|
175
|
+
if (next.length) hooks.beforeShellExecution = next;
|
|
176
|
+
else delete hooks.beforeShellExecution;
|
|
177
|
+
if (Object.keys(hooks).length) after.hooks = hooks;
|
|
178
|
+
else delete after.hooks;
|
|
179
|
+
writeJson(CURSOR_HOOKS, after);
|
|
180
|
+
audit("cursor", before, after);
|
|
181
|
+
return after;
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
function claudeConfigured() {
|
|
185
|
+
const data = readJsonTolerant(CLAUDE_SETTINGS);
|
|
186
|
+
const pre = data?.hooks?.PreToolUse;
|
|
187
|
+
if (!Array.isArray(pre)) return false;
|
|
188
|
+
return pre.some(isOurClaudeEntry);
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
function cursorConfigured() {
|
|
192
|
+
const data = readJsonTolerant(CURSOR_HOOKS);
|
|
193
|
+
const list = data?.hooks?.beforeShellExecution;
|
|
194
|
+
if (!Array.isArray(list)) return false;
|
|
195
|
+
return list.some(isOurCursorEntry);
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
|
|
199
|
+
function isOurAntigravityEntry(entry) {
|
|
200
|
+
const hooks = Array.isArray(entry?.hooks) ? entry.hooks : [];
|
|
201
|
+
return hooks.some((h) => typeof h?.command === "string" && (h.command.includes(MARKER) || h.command.includes("social-pacer-agy-hook.mjs")));
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
function antigravityEntry() {
|
|
205
|
+
return {
|
|
206
|
+
matcher: "*",
|
|
207
|
+
hooks: [{ type: "command", command: AGY_HOOK_CMD, timeout: 10 }],
|
|
208
|
+
};
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
function installAntigravity() {
|
|
212
|
+
const before = readJsonTolerant(ANTIGRAVITY_HOOKS);
|
|
213
|
+
const after = { ...before };
|
|
214
|
+
const guard = after["social-pacer-guard"] && typeof after["social-pacer-guard"] === "object"
|
|
215
|
+
? { ...after["social-pacer-guard"] }
|
|
216
|
+
: { enabled: true };
|
|
217
|
+
guard.enabled = true;
|
|
218
|
+
const pre = Array.isArray(guard.PreToolUse) ? [...guard.PreToolUse] : [];
|
|
219
|
+
const idx = pre.findIndex(isOurAntigravityEntry);
|
|
220
|
+
if (idx >= 0) {
|
|
221
|
+
pre[idx] = antigravityEntry();
|
|
222
|
+
console.log(`antigravity: updated existing PreToolUse entry -> ${AGY_HOOK_CMD}`);
|
|
223
|
+
} else {
|
|
224
|
+
pre.push(antigravityEntry());
|
|
225
|
+
console.log(`antigravity: added PreToolUse entry -> ${AGY_HOOK_CMD}`);
|
|
226
|
+
}
|
|
227
|
+
guard.PreToolUse = pre;
|
|
228
|
+
after["social-pacer-guard"] = guard;
|
|
229
|
+
writeJson(ANTIGRAVITY_HOOKS, after);
|
|
230
|
+
audit("antigravity", before, after);
|
|
231
|
+
return after;
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
function uninstallAntigravity() {
|
|
235
|
+
const before = readJsonTolerant(ANTIGRAVITY_HOOKS);
|
|
236
|
+
if (!existsSync(ANTIGRAVITY_HOOKS) && !before["social-pacer-guard"]) {
|
|
237
|
+
console.log("antigravity: nothing to uninstall");
|
|
238
|
+
audit("antigravity", before, before);
|
|
239
|
+
return before;
|
|
240
|
+
}
|
|
241
|
+
const after = { ...before };
|
|
242
|
+
delete after["social-pacer-guard"];
|
|
243
|
+
writeJson(ANTIGRAVITY_HOOKS, after);
|
|
244
|
+
audit("antigravity", before, after);
|
|
245
|
+
return after;
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
function antigravityConfigured() {
|
|
249
|
+
const data = readJsonTolerant(ANTIGRAVITY_HOOKS);
|
|
250
|
+
const pre = data?.["social-pacer-guard"]?.PreToolUse;
|
|
251
|
+
if (!Array.isArray(pre)) return false;
|
|
252
|
+
return pre.some(isOurAntigravityEntry);
|
|
253
|
+
}
|
|
254
|
+
|
|
255
|
+
function status() {
|
|
256
|
+
const pacerOk = existsSync(PACER);
|
|
257
|
+
console.log(`pacer: ${pacerOk ? "OK" : "MISSING"} ${PACER}`);
|
|
258
|
+
const cOk = claudeConfigured();
|
|
259
|
+
console.log(`claude: ${cOk ? "OK" : "MISSING"} ${HOOK_CMD}`);
|
|
260
|
+
const uOk = cursorConfigured();
|
|
261
|
+
console.log(`cursor: ${uOk ? "OK" : "MISSING"} ${HOOK_CMD}`);
|
|
262
|
+
const aOk = antigravityConfigured();
|
|
263
|
+
console.log(`antigravity: ${aOk ? "OK" : "MISSING"} ${AGY_HOOK_CMD}`);
|
|
264
|
+
return pacerOk && cOk && uOk && aOk ? 0 : 1;
|
|
265
|
+
}
|
|
266
|
+
|
|
267
|
+
function usage(exitCode = 1) {
|
|
268
|
+
console.error("Usage: node scripts/social-hooks.mjs <install|status|uninstall>");
|
|
269
|
+
return exitCode;
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
function main(argv) {
|
|
273
|
+
const [cmd] = argv;
|
|
274
|
+
switch (cmd) {
|
|
275
|
+
case "install":
|
|
276
|
+
installClaude();
|
|
277
|
+
installCursor();
|
|
278
|
+
installAntigravity();
|
|
279
|
+
return status();
|
|
280
|
+
case "uninstall":
|
|
281
|
+
uninstallClaude();
|
|
282
|
+
uninstallCursor();
|
|
283
|
+
uninstallAntigravity();
|
|
284
|
+
return 0;
|
|
285
|
+
case "status":
|
|
286
|
+
return status();
|
|
287
|
+
default:
|
|
288
|
+
return usage(1);
|
|
289
|
+
}
|
|
290
|
+
}
|
|
291
|
+
|
|
292
|
+
const code = main(process.argv.slice(2));
|
|
293
|
+
process.exit(code ?? 0);
|
|
@@ -0,0 +1,219 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* social-pacer.mjs — the only sanctioned way for an agent to drive a social
|
|
4
|
+
* account through adb (DEM-NEX-DEB-06). On 11/10/2026 @natal.facil was
|
|
5
|
+
* suspended after 14 publications in a few hours via raw `adb input tap`
|
|
6
|
+
* with 1-3 s gaps and identical sequences on a one-day-old account.
|
|
7
|
+
*
|
|
8
|
+
* social-pacer register --account A --created YYYY-MM-DD
|
|
9
|
+
* social-pacer check --account A exit 0 = may publish now
|
|
10
|
+
* social-pacer record --account A after a publication went out
|
|
11
|
+
* social-pacer tap --serial S X Y 2-15 s pause, ±6 px jitter
|
|
12
|
+
* social-pacer swipe --serial S X1 Y1 X2 Y2
|
|
13
|
+
* social-pacer screenshot --serial S [--out PATH]
|
|
14
|
+
* local PNG via `exec-out screencap -p`
|
|
15
|
+
* (never /sdcard — a PNG there enters
|
|
16
|
+
* MediaStore and precedes the target
|
|
17
|
+
* photo in the app picker)
|
|
18
|
+
* social-pacer combo --serial S K1 K2 [K3 ...]
|
|
19
|
+
* `input keycombination` after the
|
|
20
|
+
* 2-15 s pause (no jitter — not positional)
|
|
21
|
+
* social-pacer hook IDE pre-shell hook (stdin JSON)
|
|
22
|
+
*
|
|
23
|
+
* Rules (kit/rules/social-automation.mdc): accounts younger than 21 days are
|
|
24
|
+
* manual only; at most 2 publications per 24 h and never two within 4 h;
|
|
25
|
+
* the "confirm you are human" screen is always solved by the owner.
|
|
26
|
+
*/
|
|
27
|
+
import { spawnSync } from "node:child_process";
|
|
28
|
+
import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
|
|
29
|
+
import { homedir, tmpdir } from "node:os";
|
|
30
|
+
import { dirname, join, resolve } from "node:path";
|
|
31
|
+
import { pathToFileURL } from "node:url";
|
|
32
|
+
|
|
33
|
+
export const RULES = {
|
|
34
|
+
minAccountAgeDays: 21,
|
|
35
|
+
maxPublicationsPer24h: 2,
|
|
36
|
+
minHoursBetweenPublications: 4,
|
|
37
|
+
minPauseMs: 2_000,
|
|
38
|
+
maxPauseMs: 15_000,
|
|
39
|
+
jitterPx: 6,
|
|
40
|
+
};
|
|
41
|
+
|
|
42
|
+
const DAY_MS = 86_400_000;
|
|
43
|
+
const HOUR_MS = 3_600_000;
|
|
44
|
+
|
|
45
|
+
export function ledgerPath() {
|
|
46
|
+
return process.env.ZENKIT_SOCIAL_LEDGER ?? join(homedir(), ".zenkit", "social-ledger.json");
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
export function loadLedger(path = ledgerPath()) {
|
|
50
|
+
if (!existsSync(path)) return { accounts: {} };
|
|
51
|
+
return JSON.parse(readFileSync(path, "utf8"));
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
export function saveLedger(ledger, path = ledgerPath()) {
|
|
55
|
+
mkdirSync(dirname(path), { recursive: true });
|
|
56
|
+
writeFileSync(path, JSON.stringify(ledger, null, 2));
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/** May this account publish at `now`? Returns { ok, reason }. */
|
|
60
|
+
export function canPublish(ledger, account, now = Date.now()) {
|
|
61
|
+
const acc = ledger.accounts[account];
|
|
62
|
+
if (!acc) return { ok: false, reason: `conta ${account} não registrada: rode 'register --account ${account} --created AAAA-MM-DD'` };
|
|
63
|
+
const ageDays = (now - Date.parse(acc.created)) / DAY_MS;
|
|
64
|
+
if (!(ageDays >= RULES.minAccountAgeDays)) {
|
|
65
|
+
return { ok: false, reason: `conta com ${Math.floor(ageDays)} dia(s): abaixo de ${RULES.minAccountAgeDays} dias é só manual` };
|
|
66
|
+
}
|
|
67
|
+
const recent = (acc.publications ?? []).map(Date.parse).filter((t) => now - t < DAY_MS);
|
|
68
|
+
if (recent.length >= RULES.maxPublicationsPer24h) {
|
|
69
|
+
return { ok: false, reason: `já houve ${recent.length} publicação(ões) nas últimas 24 h (máximo ${RULES.maxPublicationsPer24h})` };
|
|
70
|
+
}
|
|
71
|
+
const last = Math.max(-Infinity, ...recent);
|
|
72
|
+
if (now - last < RULES.minHoursBetweenPublications * HOUR_MS) {
|
|
73
|
+
return { ok: false, reason: `última publicação há menos de ${RULES.minHoursBetweenPublications} h — nunca em sequência` };
|
|
74
|
+
}
|
|
75
|
+
return { ok: true, reason: "dentro do ritmo" };
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
export function randomPauseMs(rand = Math.random) {
|
|
79
|
+
return Math.round(RULES.minPauseMs + rand() * (RULES.maxPauseMs - RULES.minPauseMs));
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
export function jitter(value, rand = Math.random) {
|
|
83
|
+
return Math.round(Number(value) + (rand() * 2 - 1) * RULES.jitterPx);
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
const RAW_ADB_INPUT = /\badb(?:\.exe)?\b[^|;&\n]*\binput\s+(?:tap|swipe|text|keyevent|draganddrop|keycombination|keypress)\b/i;
|
|
87
|
+
|
|
88
|
+
/** True when a shell command drives the screen through raw adb input. */
|
|
89
|
+
export function isRawAdbInput(command) {
|
|
90
|
+
return RAW_ADB_INPUT.test(command) && !/social-pacer/.test(command) && !/ZENKIT_ADB_INPUT_OK=1/.test(command);
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
const HOOK_REASON =
|
|
94
|
+
"adb input direto está bloqueado (DEM-NEX-DEB-06: @natal.facil foi suspensa por toques rápidos via adb). " +
|
|
95
|
+
"Use `node <zenkit>/scripts/social-pacer.mjs tap|swipe --serial S ...` depois de `check --account`. " +
|
|
96
|
+
"Fora de rede social, prefixe o comando com ZENKIT_ADB_INPUT_OK=1 e diga por quê.";
|
|
97
|
+
|
|
98
|
+
/** Pre-shell hook for Claude Code (PreToolUse/Bash), Cursor (beforeShellExecution), and Antigravity (PreToolUse). */
|
|
99
|
+
export function hookDecision(input) {
|
|
100
|
+
const command = input?.toolCall?.args?.CommandLine ?? input?.tool_input?.command ?? input?.command ?? "";
|
|
101
|
+
if (!isRawAdbInput(command)) return null;
|
|
102
|
+
if (input?.toolCall) {
|
|
103
|
+
return { decision: "deny", reason: HOOK_REASON };
|
|
104
|
+
}
|
|
105
|
+
if (input?.tool_input) {
|
|
106
|
+
return { hookSpecificOutput: { hookEventName: "PreToolUse", permissionDecision: "deny", permissionDecisionReason: HOOK_REASON } };
|
|
107
|
+
}
|
|
108
|
+
return { permission: "deny", userMessage: HOOK_REASON, agentMessage: HOOK_REASON };
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
function arg(args, name) {
|
|
112
|
+
const i = args.indexOf(`--${name}`);
|
|
113
|
+
return i >= 0 ? args[i + 1] : undefined;
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
function adbSpawn(serial, adbArgs, opts = {}) {
|
|
117
|
+
return spawnSync("adb", [...(serial ? ["-s", serial] : []), ...adbArgs], opts);
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
function adbInput(serial, subcommand, ...rest) {
|
|
121
|
+
const r = adbSpawn(serial, ["shell", "input", subcommand, ...rest], { stdio: "inherit" });
|
|
122
|
+
if (r.status !== 0) throw new Error(`adb input ${subcommand} falhou (status ${r.status})`);
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
|
|
126
|
+
|
|
127
|
+
async function main(argv) {
|
|
128
|
+
const [cmd, ...args] = argv;
|
|
129
|
+
const positional = args.filter((a, i) => !a.startsWith("--") && !args[i - 1]?.startsWith("--"));
|
|
130
|
+
switch (cmd) {
|
|
131
|
+
case "register": {
|
|
132
|
+
const account = arg(args, "account");
|
|
133
|
+
const created = arg(args, "created");
|
|
134
|
+
if (!account || !/^\d{4}-\d{2}-\d{2}$/.test(created ?? "")) throw new Error("uso: register --account A --created AAAA-MM-DD");
|
|
135
|
+
const ledger = loadLedger();
|
|
136
|
+
ledger.accounts[account] = { ...(ledger.accounts[account] ?? { publications: [] }), created };
|
|
137
|
+
saveLedger(ledger);
|
|
138
|
+
console.log(`registrada: ${account} (criada em ${created})`);
|
|
139
|
+
return 0;
|
|
140
|
+
}
|
|
141
|
+
case "check": {
|
|
142
|
+
const r = canPublish(loadLedger(), arg(args, "account"));
|
|
143
|
+
console.log(`${r.ok ? "PODE" : "NÃO PODE"} publicar: ${r.reason}`);
|
|
144
|
+
return r.ok ? 0 : 1;
|
|
145
|
+
}
|
|
146
|
+
case "record": {
|
|
147
|
+
const account = arg(args, "account");
|
|
148
|
+
const ledger = loadLedger();
|
|
149
|
+
const r = canPublish(ledger, account);
|
|
150
|
+
if (!r.ok) {
|
|
151
|
+
console.error(`registro recusado: ${r.reason}`);
|
|
152
|
+
return 1;
|
|
153
|
+
}
|
|
154
|
+
ledger.accounts[account].publications.push(new Date().toISOString());
|
|
155
|
+
saveLedger(ledger);
|
|
156
|
+
console.log(`publicação registrada para ${account}`);
|
|
157
|
+
return 0;
|
|
158
|
+
}
|
|
159
|
+
case "tap":
|
|
160
|
+
case "swipe": {
|
|
161
|
+
const want = cmd === "tap" ? 2 : 4;
|
|
162
|
+
if (positional.length !== want) throw new Error(`uso: ${cmd} --serial S ${cmd === "tap" ? "X Y" : "X1 Y1 X2 Y2"}`);
|
|
163
|
+
await sleep(randomPauseMs());
|
|
164
|
+
adbInput(arg(args, "serial"), cmd, ...positional.map((v) => String(jitter(v))));
|
|
165
|
+
return 0;
|
|
166
|
+
}
|
|
167
|
+
case "screenshot": {
|
|
168
|
+
const serial = arg(args, "serial");
|
|
169
|
+
const out = arg(args, "out") ?? join(tmpdir(), "zenkit-social", `shot-${Date.now()}.png`);
|
|
170
|
+
mkdirSync(dirname(out), { recursive: true });
|
|
171
|
+
const r = adbSpawn(serial, ["exec-out", "screencap", "-p"], {
|
|
172
|
+
maxBuffer: 32 * 1024 * 1024,
|
|
173
|
+
});
|
|
174
|
+
if (r.error || r.status !== 0) {
|
|
175
|
+
console.error(`screencap falhou: ${r.error?.message ?? `adb saiu com status ${r.status}`}`);
|
|
176
|
+
return 1;
|
|
177
|
+
}
|
|
178
|
+
writeFileSync(out, r.stdout);
|
|
179
|
+
console.log(resolve(out));
|
|
180
|
+
return 0;
|
|
181
|
+
}
|
|
182
|
+
case "combo": {
|
|
183
|
+
const serial = arg(args, "serial");
|
|
184
|
+
if (positional.length < 2 || !positional.every((c) => /^\d+$/.test(c))) {
|
|
185
|
+
throw new Error("uso: combo --serial S K1 K2 [K3 ...] (pelo menos dois códigos numéricos)");
|
|
186
|
+
}
|
|
187
|
+
await sleep(randomPauseMs());
|
|
188
|
+
adbInput(serial, "keycombination", ...positional);
|
|
189
|
+
return 0;
|
|
190
|
+
}
|
|
191
|
+
case "hook": {
|
|
192
|
+
let raw = "";
|
|
193
|
+
for await (const chunk of process.stdin) raw += chunk;
|
|
194
|
+
let input = {};
|
|
195
|
+
try {
|
|
196
|
+
input = JSON.parse(raw || "{}");
|
|
197
|
+
} catch {
|
|
198
|
+
return 0;
|
|
199
|
+
}
|
|
200
|
+
const decision = hookDecision(input);
|
|
201
|
+
if (decision) process.stdout.write(JSON.stringify(decision));
|
|
202
|
+
else if (input?.toolCall) process.stdout.write(JSON.stringify({ decision: "allow" }));
|
|
203
|
+
else if (!input.tool_input) process.stdout.write(JSON.stringify({ permission: "allow" }));
|
|
204
|
+
return 0;
|
|
205
|
+
}
|
|
206
|
+
default:
|
|
207
|
+
console.error("uso: social-pacer register|check|record|tap|swipe|screenshot|combo|hook (veja o cabeçalho do arquivo)");
|
|
208
|
+
return 2;
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href) {
|
|
213
|
+
main(process.argv.slice(2))
|
|
214
|
+
.then((code) => process.exit(code))
|
|
215
|
+
.catch((e) => {
|
|
216
|
+
console.error(e.message);
|
|
217
|
+
process.exit(1);
|
|
218
|
+
});
|
|
219
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* validate-bundles.mjs — um bundle que cita skill inexistente tem de reprovar.
|
|
4
|
+
* Sem isso o manifesto apodrece em silêncio (docs/bundles.md).
|
|
5
|
+
*/
|
|
6
|
+
import { validateBundles } from "./bundle.mjs";
|
|
7
|
+
|
|
8
|
+
const { problemas, count } = await validateBundles();
|
|
9
|
+
if (problemas.length > 0) {
|
|
10
|
+
console.error(`⛔ ${problemas.length} problema(s) em ${count} bundles:\n`);
|
|
11
|
+
for (const p of problemas) console.error(` - ${p}`);
|
|
12
|
+
process.exit(1);
|
|
13
|
+
}
|
|
14
|
+
console.log(`✅ ${count} bundles válidos (nome, includes, skills e agentes existem).`);
|