@event4u/agent-config 8.1.0 → 8.3.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/.claude-plugin/marketplace.json +3 -3
- package/CHANGELOG.md +83 -292
- package/MIGRATION.md +18 -0
- package/README.md +86 -3
- package/dist/agent-src/commands/agents/init.md +3 -3
- package/dist/agent-src/commands/chat-history/import.md +5 -5
- package/dist/agent-src/commands/chat-history.md +1 -1
- package/dist/agent-src/commands/condense.md +1 -1
- package/dist/agent-src/commands/context/create.md +1 -1
- package/dist/agent-src/commands/council/analysis.md +2 -2
- package/dist/agent-src/commands/council/default.md +3 -3
- package/dist/agent-src/commands/council/design.md +2 -2
- package/dist/agent-src/commands/council/optimize.md +1 -1
- package/dist/agent-src/commands/council/pr.md +2 -2
- package/dist/agent-src/commands/council.md +1 -1
- package/dist/agent-src/commands/feature/plan.md +1 -1
- package/dist/agent-src/commands/ghostwriter/list.md +1 -1
- package/dist/agent-src/commands/ghostwriter/write.md +1 -1
- package/dist/agent-src/commands/ghostwriter.md +1 -1
- package/dist/agent-src/commands/implement-ticket.md +2 -2
- package/dist/agent-src/commands/judge/on-diff.md +1 -1
- package/dist/agent-src/commands/judge/steps.md +3 -1
- package/dist/agent-src/commands/memory/add.md +2 -2
- package/dist/agent-src/commands/memory/learn-low-impact.md +1 -1
- package/dist/agent-src/commands/memory/load.md +1 -1
- package/dist/agent-src/commands/memory/mine-session.md +1 -1
- package/dist/agent-src/commands/memory/promote.md +1 -1
- package/dist/agent-src/commands/memory/propose.md +1 -1
- package/dist/agent-src/commands/mission/upgrade.md +1 -1
- package/dist/agent-src/commands/module/explore.md +3 -3
- package/dist/agent-src/commands/optimize/agents-dir.md +1 -1
- package/dist/agent-src/commands/optimize/skills.md +1 -1
- package/dist/agent-src/commands/optimize-project.md +1 -1
- package/dist/agent-src/commands/orchestrate.md +2 -2
- package/dist/agent-src/commands/project-analyze.md +1 -1
- package/dist/agent-src/commands/project-health.md +1 -1
- package/dist/agent-src/commands/roadmap/ai-council.md +1 -1
- package/dist/agent-src/commands/roadmap/create.md +2 -2
- package/dist/agent-src/commands/roadmap/process-full.md +3 -1
- package/dist/agent-src/commands/roadmap/process-phase.md +4 -2
- package/dist/agent-src/commands/roadmap/process-step.md +3 -1
- package/dist/agent-src/commands/security-audit-config.md +1 -1
- package/dist/agent-src/commands/sync-agent-settings.md +7 -7
- package/dist/agent-src/commands/sync-gitignore/fix.md +3 -3
- package/dist/agent-src/commands/sync-gitignore.md +4 -4
- package/dist/agent-src/commands/work.md +3 -3
- package/dist/agent-src/contexts/communication/rules-auto/skill-quality-mechanics.md +1 -1
- package/dist/agent-src/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md +2 -2
- package/dist/agent-src/contexts/contracts/artifact-engagement-flow.md +1 -1
- package/dist/agent-src/contexts/contracts/command-suggestion-flow.md +8 -7
- package/dist/agent-src/contexts/execution/evidence-discipline.md +2 -2
- package/dist/agent-src/contexts/execution/roadmap-process-loop.md +9 -4
- package/dist/agent-src/contexts/execution/toolchain-resolver.md +10 -9
- package/dist/agent-src/contexts/execution/verification-mechanics.md +13 -1
- package/dist/agent-src/packs/README.md +1 -1
- package/dist/agent-src/presets/README.md +1 -1
- package/dist/agent-src/profiles/README.md +1 -1
- package/dist/agent-src/rules/architecture.md +2 -2
- package/dist/agent-src/rules/context-hygiene.md +2 -2
- package/dist/agent-src/rules/fast-path-marker-visibility.md +1 -1
- package/dist/agent-src/rules/framework-neutrality-in-generic-skills.md +1 -1
- package/dist/agent-src/rules/linked-projects-onboarding-gate.md +1 -1
- package/dist/agent-src/rules/low-impact-corpus-privacy-floor.md +3 -3
- package/dist/agent-src/rules/media-governance-routing.md +1 -1
- package/dist/agent-src/rules/no-roadmap-references.md +3 -3
- package/dist/agent-src/rules/preservation-guard.md +2 -2
- package/dist/agent-src/rules/roadmap-ci-steps-policy.md +6 -5
- package/dist/agent-src/rules/roadmap-progress-sync.md +3 -3
- package/dist/agent-src/rules/security-sensitive-stop.md +7 -9
- package/dist/agent-src/rules/source-confidentiality.md +1 -1
- package/dist/agent-src/rules/telegraph-speak.md +1 -1
- package/dist/agent-src/rules/token-optimizer-maintenance.md +1 -1
- package/dist/agent-src/rules/ui-audit-gate.md +1 -1
- package/dist/agent-src/scripts/archive_completed_roadmaps.ts +22 -4
- package/dist/agent-src/scripts/update_roadmap_progress.ts +29 -1
- package/dist/agent-src/skills/accessibility-auditor/SKILL.md +3 -2
- package/dist/agent-src/skills/adr-create/SKILL.md +8 -6
- package/dist/agent-src/skills/agent-docs-writing/SKILL.md +1 -1
- package/dist/agent-src/skills/agents-md-thin-root/SKILL.md +2 -2
- package/dist/agent-src/skills/ai-council/SKILL.md +15 -15
- package/dist/agent-src/skills/api-design/SKILL.md +1 -1
- package/dist/agent-src/skills/api-endpoint/SKILL.md +2 -1
- package/dist/agent-src/skills/authz-review/SKILL.md +1 -1
- package/dist/agent-src/skills/blade-ui/SKILL.md +11 -10
- package/dist/agent-src/skills/blameless-post-mortem/SKILL.md +9 -8
- package/dist/agent-src/skills/code-review/SKILL.md +3 -4
- package/dist/agent-src/skills/command-routing/SKILL.md +3 -3
- package/dist/agent-src/skills/command-writing/SKILL.md +3 -3
- package/dist/agent-src/skills/condense-memory/SKILL.md +2 -2
- package/dist/agent-src/skills/context-authoring/SKILL.md +1 -1
- package/dist/agent-src/skills/context-document/SKILL.md +1 -1
- package/dist/agent-src/skills/copilot-agents-optimization/SKILL.md +1 -1
- package/dist/agent-src/skills/corpus-grounding/SKILL.md +16 -11
- package/dist/agent-src/skills/corpus-grounding/scripts/ground.ts +24 -3
- package/dist/agent-src/skills/dashboard-design/SKILL.md +2 -1
- package/dist/agent-src/skills/database/SKILL.md +2 -1
- package/dist/agent-src/skills/description-assist/SKILL.md +6 -6
- package/dist/agent-src/skills/design-intelligence/SKILL.md +6 -5
- package/dist/agent-src/skills/design-tokens/SKILL.md +5 -5
- package/dist/agent-src/skills/design-tokens/scripts/tokens.ts +24 -3
- package/dist/agent-src/skills/existing-ui-audit/SKILL.md +3 -3
- package/dist/agent-src/skills/fe-design/SKILL.md +7 -7
- package/dist/agent-src/skills/finishing-a-development-branch/SKILL.md +11 -4
- package/dist/agent-src/skills/flux/SKILL.md +10 -9
- package/dist/agent-src/skills/git-workflow/SKILL.md +4 -5
- package/dist/agent-src/skills/guideline-writing/SKILL.md +2 -2
- package/dist/agent-src/skills/learning-to-rule-or-skill/SKILL.md +2 -2
- package/dist/agent-src/skills/livewire/SKILL.md +10 -9
- package/dist/agent-src/skills/memory-consolidation/SKILL.md +2 -2
- package/dist/agent-src/skills/module-detect-on-the-fly/SKILL.md +5 -5
- package/dist/agent-src/skills/module-management/SKILL.md +2 -2
- package/dist/agent-src/skills/prediction-pool-optimizer/SKILL.md +11 -11
- package/dist/agent-src/skills/prediction-pool-optimizer/reference/ev-fixtures.md +6 -6
- package/dist/agent-src/skills/prediction-pool-optimizer/reference/odds-and-bonus.md +1 -1
- package/dist/agent-src/skills/premortem/SKILL.md +1 -1
- package/dist/agent-src/skills/project-docs/SKILL.md +1 -1
- package/dist/agent-src/skills/quality-tools/SKILL.md +26 -2
- package/dist/agent-src/skills/react-shadcn-ui/SKILL.md +8 -7
- package/dist/agent-src/skills/react-shadcn-ui/scripts/shadcn_add.ts +31 -10
- package/dist/agent-src/skills/refine-prompt/SKILL.md +14 -14
- package/dist/agent-src/skills/refine-ticket/SKILL.md +24 -25
- package/dist/agent-src/skills/refine-ticket/detection-map.yml +1 -1
- package/dist/agent-src/skills/review-routing/SKILL.md +6 -7
- package/dist/agent-src/skills/roadmap-management/SKILL.md +11 -6
- package/dist/agent-src/skills/rule-refactor/SKILL.md +1 -1
- package/dist/agent-src/skills/rule-writing/SKILL.md +5 -5
- package/dist/agent-src/skills/script-writing/SKILL.md +28 -41
- package/dist/agent-src/skills/skill-writing/SKILL.md +3 -3
- package/dist/agent-src/skills/source-discovery/SKILL.md +3 -3
- package/dist/agent-src/skills/sql-writing/SKILL.md +2 -1
- package/dist/agent-src/skills/subagent-orchestration/SKILL.md +1 -1
- package/dist/agent-src/skills/systematic-debugging/SKILL.md +5 -7
- package/dist/agent-src/skills/tailwind-engineer/SKILL.md +2 -2
- package/dist/agent-src/skills/tailwind-engineer/scripts/tailwind_config_gen.ts +25 -4
- package/dist/agent-src/skills/token-optimizer/SKILL.md +1 -1
- package/dist/agent-src/skills/typography-system/SKILL.md +1 -1
- package/dist/agent-src/skills/validate-feature-fit/SKILL.md +5 -7
- package/dist/agent-src/skills/verify-completion-evidence/SKILL.md +13 -1
- package/dist/agent-src/templates/agent-settings.md +34 -25
- package/dist/agent-src/templates/agents/agent-project-settings.example.yml +3 -3
- package/dist/agent-src/templates/agents/memory/incident-learnings.example.yml +1 -1
- package/dist/agent-src/templates/agents/proposal.example.md +4 -4
- package/dist/agent-src/templates/copilot-instructions.md +1 -1
- package/dist/agent-src/templates/github-workflows/memory-hygiene.yml +10 -10
- package/dist/agent-src/templates/github-workflows/pr-risk-review.yml +19 -8
- package/dist/agent-src/templates/github-workflows/proposal-drift.yml +11 -8
- package/dist/agent-src/templates/github-workflows/roadmap-progress-check.yml +10 -12
- package/dist/agent-src/templates/hooks/pre-commit-frontmatter +21 -11
- package/dist/agent-src/templates/hooks/pre-commit-roadmap-progress +43 -29
- package/dist/agent-src/templates/roadmaps.md +9 -4
- package/dist/agent-src/templates/rule.md +3 -3
- package/dist/agent-src/templates/scripts/README.md +6 -6
- package/dist/agent-src/templates/scripts/check_memory.ts +24 -2
- package/dist/agent-src/templates/scripts/check_memory_proposal.ts +23 -4
- package/dist/agent-src/templates/scripts/historical-bug-patterns.example.yml +1 -1
- package/dist/agent-src/templates/scripts/memory_hash.ts +24 -2
- package/dist/agent-src/templates/scripts/memory_lookup.ts +24 -2
- package/dist/agent-src/templates/scripts/memory_report.ts +24 -2
- package/dist/agent-src/templates/scripts/memory_signal.ts +24 -2
- package/dist/agent-src/templates/scripts/memory_status.ts +26 -2
- package/dist/agent-src/templates/scripts/ownership-map.example.yml +1 -1
- package/dist/agent-src/templates/scripts/pr-risk-config.example.yml +1 -1
- package/dist/agent-src/templates/scripts/pr_review_routing.ts +24 -3
- package/dist/agent-src/templates/scripts/pr_risk_review.ts +0 -0
- package/dist/agent-src/templates/scripts/telemetry_record.ts +24 -3
- package/dist/agent-src/templates/scripts/telemetry_report.ts +25 -3
- package/dist/agent-src/templates/scripts/telemetry_status.ts +24 -3
- package/dist/agent-src/templates/scripts/tier_usage_report.ts +24 -2
- package/dist/agent-src/templates/scripts/work_engine/_lib/agent_settings.ts +44 -10
- package/dist/agent-src/templates/scripts/work_engine/hooks/builtin/_chat_history_base.ts +26 -13
- package/dist/agent-src/templates/skill.md +2 -2
- package/dist/cli/python/knowledge_ingest.js +24 -3
- package/dist/cli/python/knowledge_ingest.js.map +1 -1
- package/dist/cli/python/workspace_analytics.js +23 -3
- package/dist/cli/python/workspace_analytics.js.map +1 -1
- package/dist/cli/python/workspace_crypto.js +23 -3
- package/dist/cli/python/workspace_crypto.js.map +1 -1
- package/dist/cli/python/workspace_documents.js +23 -3
- package/dist/cli/python/workspace_documents.js.map +1 -1
- package/dist/cli/python/workspace_drive.js +24 -3
- package/dist/cli/python/workspace_drive.js.map +1 -1
- package/dist/cli/python/workspace_drive_health.js +23 -3
- package/dist/cli/python/workspace_drive_health.js.map +1 -1
- package/dist/cli/python/workspace_explain.js +23 -3
- package/dist/cli/python/workspace_explain.js.map +1 -1
- package/dist/cli/python/workspace_hosts.js +23 -3
- package/dist/cli/python/workspace_hosts.js.map +1 -1
- package/dist/cli/python/workspace_inbox.js +23 -3
- package/dist/cli/python/workspace_inbox.js.map +1 -1
- package/dist/cli/python/workspace_render.js +23 -3
- package/dist/cli/python/workspace_render.js.map +1 -1
- package/dist/cli/python/workspace_roles.js +23 -3
- package/dist/cli/python/workspace_roles.js.map +1 -1
- package/dist/cli/python/workspace_sessions.js +23 -3
- package/dist/cli/python/workspace_sessions.js.map +1 -1
- package/dist/cli/python/workspace_skills.js +23 -3
- package/dist/cli/python/workspace_skills.js.map +1 -1
- package/dist/cli/registry.js +2 -0
- package/dist/cli/registry.js.map +1 -1
- package/dist/discovery/deprecation-report.md +1 -1
- package/dist/discovery/discovery-manifest.json +118 -118
- package/dist/discovery/discovery-manifest.json.sha256 +1 -1
- package/dist/discovery/discovery-manifest.summary.md +2 -2
- package/dist/discovery/orphan-report.md +1 -1
- package/dist/discovery/packs.json +3 -3
- package/dist/discovery/trust-report.md +1 -1
- package/dist/discovery/workspaces.json +3 -3
- package/dist/install/install.mjs +647 -408
- package/dist/mcp/registry-manifest.json +3 -3
- package/dist/server/routes/settings.js +4 -4
- package/dist/server/routes/settings.js.map +1 -1
- package/dist/server/schemas/settings.js +1 -1
- package/dist/server/schemas/settings.js.map +1 -1
- package/docs/CLAIMS.md +2 -2
- package/docs/archive/CHANGELOG-pre-8.1.0.md +316 -0
- package/docs/benchmark.md +40 -0
- package/docs/contracts/CHANGELOG-conventions.md +8 -5
- package/docs/contracts/branch-protection-policy.md +14 -5
- package/docs/contracts/mcp-phase-1-scope.md +75 -0
- package/docs/contracts/mcp-tool-inventory.md +22 -15
- package/docs/contracts/release-pr-gating.md +22 -11
- package/docs/contracts/skill-bundled-assets.md +2 -2
- package/docs/customization.md +1 -1
- package/docs/decisions/ADR-110-discipline-profile-resolution-locus.md +9 -4
- package/docs/decisions/ADR-111-canonical-glama-listing.md +97 -0
- package/docs/decisions/ADR-112-stdio-lite-stays-read-only.md +92 -0
- package/docs/decisions/ADR-113-ci-native-release-label-trigger.md +201 -0
- package/docs/decisions/INDEX.md +3 -0
- package/docs/distribution/registry-submissions.md +1 -1
- package/docs/getting-started.md +8 -6
- package/docs/guidelines/agent-infra/corpus-grounding-authoring.md +2 -2
- package/docs/guidelines/agent-infra/engineering-memory-data-format.md +4 -4
- package/docs/guidelines/agent-infra/installed-tools-manifest.md +3 -3
- package/docs/guidelines/agent-infra/language-and-tone-examples.md +2 -2
- package/docs/guidelines/agent-infra/layered-settings.md +4 -4
- package/docs/guidelines/agent-infra/memory-access.md +19 -18
- package/docs/guidelines/agent-infra/naming.md +1 -1
- package/docs/guidelines/agent-infra/roadmap-progress-mechanics.md +5 -5
- package/docs/guidelines/agent-infra/role-contracts.md +1 -1
- package/docs/guidelines/agent-infra/security-lint-containment.md +2 -2
- package/docs/guidelines/agent-infra/self-improvement-pipeline.md +1 -1
- package/docs/guidelines/agent-infra/size-and-scope.md +1 -1
- package/docs/guidelines/agent-infra/skill-quality-checklist.md +5 -5
- package/docs/guidelines/augment-portability-patterns.md +1 -1
- package/docs/installation.md +13 -14
- package/docs/mcp-server.md +32 -20
- package/docs/proof.md +1 -1
- package/docs/setup/mcp-cloud-endpoints.md +9 -2
- package/docs/setup/per-ide/claude-code.md +10 -4
- package/package.json +4 -3
- package/src/config/agent-settings.template.yml +31 -17
- package/src/config/host-capabilities.yml +25 -16
- package/src/config/profiles/balanced.ini +5 -3
- package/src/scripts/_cli/cmd_analyze_session.ts +23 -4
- package/src/scripts/_cli/cmd_conformance.ts +23 -4
- package/src/scripts/_cli/cmd_doctor.ts +196 -8
- package/src/scripts/_cli/cmd_explain.ts +23 -4
- package/src/scripts/_cli/cmd_export.ts +23 -4
- package/src/scripts/_cli/cmd_fleet.ts +23 -4
- package/src/scripts/_cli/cmd_migrate.ts +23 -4
- package/src/scripts/_cli/cmd_preflight.ts +24 -4
- package/src/scripts/_cli/cmd_prune.ts +23 -4
- package/src/scripts/_cli/cmd_refresh.ts +23 -4
- package/src/scripts/_cli/cmd_settings_check.ts +23 -4
- package/src/scripts/_cli/cmd_settings_migrate.ts +23 -4
- package/src/scripts/_cli/cmd_sync.ts +23 -4
- package/src/scripts/_cli/cmd_uninstall.ts +45 -4
- package/src/scripts/_cli/cmd_update.ts +23 -4
- package/src/scripts/_cli/cmd_upgrade.ts +307 -17
- package/src/scripts/_cli/cmd_validate.ts +23 -4
- package/src/scripts/_cli/cmd_versions.ts +23 -4
- package/src/scripts/_dispatch.bash +62 -19
- package/src/scripts/_lib/claude_plugin.ts +83 -0
- package/src/scripts/_lib/claude_settings_hooks.ts +251 -0
- package/src/scripts/_lib/knowledge_global.ts +24 -2
- package/src/scripts/_lib/knowledge_global_promote.ts +24 -2
- package/src/scripts/_lib/knowledge_global_redaction.ts +24 -2
- package/src/scripts/_lib/link_crypto.ts +24 -5
- package/src/scripts/_lib/pin_resolver.ts +24 -3
- package/src/scripts/adoption_report.ts +23 -4
- package/src/scripts/adoption_snapshot.ts +23 -1
- package/src/scripts/adoption_status.ts +23 -4
- package/src/scripts/adr/regenerate_index.ts +24 -3
- package/src/scripts/ai_council/airgap.ts +25 -2
- package/src/scripts/ai_council/compile_corpus.ts +24 -2
- package/src/scripts/ai_council/pricing.ts +11 -1
- package/src/scripts/analysis_freshness.ts +23 -4
- package/src/scripts/annotate_discovery.ts +23 -1
- package/src/scripts/apply_modules_config.ts +23 -4
- package/src/scripts/audit_adr_coverage.ts +23 -4
- package/src/scripts/audit_auto_rules.ts +23 -1
- package/src/scripts/audit_cloud_compatibility.ts +23 -4
- package/src/scripts/audit_command_surface.ts +23 -4
- package/src/scripts/audit_initial_context.ts +23 -3
- package/src/scripts/audit_likelihood.ts +23 -1
- package/src/scripts/audit_mcp_tools.ts +23 -3
- package/src/scripts/audit_overlap.ts +23 -1
- package/src/scripts/audit_skill_descriptions.ts +24 -2
- package/src/scripts/audit_skill_overlap.ts +23 -1
- package/src/scripts/audit_user_type_axis.ts +23 -4
- package/src/scripts/backfill_model_tier.ts +23 -4
- package/src/scripts/bench_ab_cache_dispatch.ts +23 -1
- package/src/scripts/bench_ab_clone.ts +23 -1
- package/src/scripts/bench_ab_diff.ts +23 -1
- package/src/scripts/bench_ab_integrity.ts +23 -1
- package/src/scripts/bench_ab_run.ts +23 -2
- package/src/scripts/bench_ab_task_runner.ts +23 -1
- package/src/scripts/bench_ab_tracka_run.ts +23 -2
- package/src/scripts/bench_ab_v2_run.ts +23 -1
- package/src/scripts/bench_ab_v2_stats.ts +23 -1
- package/src/scripts/bench_baseline_ready.ts +23 -1
- package/src/scripts/bench_condense_memory.ts +23 -1
- package/src/scripts/bench_drift_check.ts +23 -2
- package/src/scripts/bench_matrix.ts +23 -4
- package/src/scripts/bench_per_tool.ts +23 -1
- package/src/scripts/bench_quality_run.ts +23 -2
- package/src/scripts/bench_rtk_savings.ts +23 -1
- package/src/scripts/bench_rule_load_latency.ts +23 -2
- package/src/scripts/bench_run.ts +23 -2
- package/src/scripts/bench_runner.ts +23 -1
- package/src/scripts/build_cloud_bundle.ts +23 -3
- package/src/scripts/build_discovery_manifest.ts +23 -4
- package/src/scripts/build_linear_digest.ts +23 -3
- package/src/scripts/build_mcp_registry_manifest.ts +23 -4
- package/src/scripts/build_rule_trigger_matrix.ts +23 -4
- package/src/scripts/capture_showcase_session.ts +23 -1
- package/src/scripts/chat_history.ts +24 -3
- package/src/scripts/check_always_budget.ts +23 -2
- package/src/scripts/check_artefact_checksums.ts +23 -4
- package/src/scripts/check_augment_description_cap.ts +23 -4
- package/src/scripts/check_augmentignore.ts +23 -4
- package/src/scripts/check_beta_review_markers.ts +23 -4
- package/src/scripts/check_cluster_patterns.ts +23 -4
- package/src/scripts/check_command_count_messaging.ts +23 -4
- package/src/scripts/check_comparison.ts +23 -1
- package/src/scripts/check_condensation.ts +24 -3
- package/src/scripts/check_condensed_paths.ts +23 -2
- package/src/scripts/check_context_paths.ts +23 -4
- package/src/scripts/check_council_config_location.ts +23 -4
- package/src/scripts/check_council_layout.ts +23 -4
- package/src/scripts/check_council_references.ts +23 -4
- package/src/scripts/check_discovery_determinism.ts +24 -4
- package/src/scripts/check_gate_paths.ts +23 -4
- package/src/scripts/check_generated_artefact_headers.ts +23 -4
- package/src/scripts/check_generator_output_coverage.ts +23 -4
- package/src/scripts/check_gitignore_freshness.ts +23 -4
- package/src/scripts/check_iron_law_prominence.ts +23 -4
- package/src/scripts/check_kernel_prefix_stability.ts +0 -0
- package/src/scripts/check_kernel_rule_bundle.ts +23 -4
- package/src/scripts/check_knowledge_cards.ts +23 -1
- package/src/scripts/check_md_language.ts +23 -4
- package/src/scripts/check_media_deps.ts +24 -1
- package/src/scripts/check_memory.ts +24 -2
- package/src/scripts/check_memory_proposal.ts +23 -4
- package/src/scripts/check_module_management_neutral.ts +23 -4
- package/src/scripts/check_no_conflict_markers.ts +23 -4
- package/src/scripts/check_no_external_sources.ts +23 -4
- package/src/scripts/check_no_local_settings_committed.ts +24 -4
- package/src/scripts/check_no_new_legacy_path.ts +23 -4
- package/src/scripts/check_no_roadmap_refs.ts +23 -4
- package/src/scripts/check_one_off_location.ts +23 -4
- package/src/scripts/check_overlay_cascade_subdirs.ts +23 -4
- package/src/scripts/check_portability.ts +24 -3
- package/src/scripts/check_proposal.ts +0 -0
- package/src/scripts/check_public_catalog_links.ts +23 -4
- package/src/scripts/check_public_links.ts +23 -4
- package/src/scripts/check_quality_regression.ts +23 -2
- package/src/scripts/check_references.ts +23 -4
- package/src/scripts/check_release_includes_discovery.ts +23 -4
- package/src/scripts/check_release_pr_shape.ts +23 -4
- package/src/scripts/check_release_published.ts +23 -4
- package/src/scripts/check_release_trunk_sync.ts +23 -4
- package/src/scripts/check_reply_consistency.ts +23 -4
- package/src/scripts/check_roadmap_trackable.ts +23 -4
- package/src/scripts/check_role_doc_links.ts +23 -4
- package/src/scripts/check_safety_floor_untouched.ts +24 -4
- package/src/scripts/check_site_links.ts +23 -1
- package/src/scripts/check_skill_gaps.ts +23 -1
- package/src/scripts/check_skill_requires.ts +23 -4
- package/src/scripts/check_structural_breaking.ts +24 -4
- package/src/scripts/check_surface_tiers.ts +23 -4
- package/src/scripts/check_template_pin_drift.ts +23 -4
- package/src/scripts/check_test_coverage_diff.ts +23 -4
- package/src/scripts/check_token_optimizer_freshness.ts +23 -4
- package/src/scripts/check_token_quality_golden.ts +23 -2
- package/src/scripts/check_token_regression.ts +23 -2
- package/src/scripts/check_tracked_but_ignored.ts +24 -4
- package/src/scripts/check_trigger_evals.ts +23 -4
- package/src/scripts/check_trunk_drift.ts +24 -1
- package/src/scripts/check_update_banner.ts +23 -4
- package/src/scripts/ci_summary.ts +23 -4
- package/src/scripts/ci_time_ratio.ts +23 -4
- package/src/scripts/cluster_near_miss_patterns.ts +0 -0
- package/src/scripts/compile_router.ts +23 -4
- package/src/scripts/condense.ts +30 -31
- package/src/scripts/condense_memory.ts +24 -2
- package/src/scripts/config/packs.ts +24 -4
- package/src/scripts/config/session_profiles.ts +23 -4
- package/src/scripts/context_hygiene_hook.ts +24 -3
- package/src/scripts/cost_by_conversation.ts +23 -4
- package/src/scripts/cost_summary.ts +23 -4
- package/src/scripts/council_cli.ts +35 -7
- package/src/scripts/council_prune.ts +25 -2
- package/src/scripts/cross_repo_retrieve.ts +23 -4
- package/src/scripts/discovery_stats.ts +23 -4
- package/src/scripts/evidence_report.ts +23 -1
- package/src/scripts/export_replay_corpus.ts +23 -2
- package/src/scripts/extract_audit_patterns.ts +23 -1
- package/src/scripts/first_run_gate_hook.ts +24 -3
- package/src/scripts/gen_discovery_baseline.ts +23 -4
- package/src/scripts/generate_capabilities_index.ts +24 -5
- package/src/scripts/generate_capability_matrix.ts +23 -4
- package/src/scripts/generate_catalog.ts +23 -1
- package/src/scripts/generate_command_flows.ts +23 -4
- package/src/scripts/generate_cookbook.ts +23 -4
- package/src/scripts/generate_index.ts +23 -4
- package/src/scripts/generate_ownership_matrix.ts +23 -1
- package/src/scripts/generate_pack_manifests.ts +24 -5
- package/src/scripts/generate_role_experiences_catalog.ts +23 -4
- package/src/scripts/hooks/block_no_verify.ts +23 -4
- package/src/scripts/hooks/design_slop_hook.ts +24 -3
- package/src/scripts/hooks/dispatch_hook.ts +47 -14
- package/src/scripts/hooks/replay_hook.ts +23 -2
- package/src/scripts/hooks/rtk_wrap_hook.ts +24 -5
- package/src/scripts/hooks_doctor.ts +23 -2
- package/src/scripts/hooks_status.ts +23 -2
- package/src/scripts/injection_scan_hook.ts +24 -5
- package/src/scripts/install +23 -4
- package/src/scripts/install.ts +102 -44
- package/src/scripts/inventory_abstraction_budget.ts +23 -1
- package/src/scripts/inventory_frontmatter.ts +23 -1
- package/src/scripts/inventory_meta_layers.ts +23 -1
- package/src/scripts/iron_law_sha.ts +23 -4
- package/src/scripts/janitor.ts +23 -4
- package/src/scripts/knowledge_global_cli.ts +24 -2
- package/src/scripts/linked_projects_list.ts +23 -4
- package/src/scripts/lint_agent_security.ts +23 -4
- package/src/scripts/lint_agent_skill_names.ts +23 -4
- package/src/scripts/lint_agents_layout.ts +23 -4
- package/src/scripts/lint_agents_md.ts +23 -4
- package/src/scripts/lint_archived_skills.ts +23 -4
- package/src/scripts/lint_artefact_frontmatter.ts +23 -4
- package/src/scripts/lint_bench_ab.ts +23 -4
- package/src/scripts/lint_bench_corpus.ts +23 -2
- package/src/scripts/lint_command_flow_coverage.ts +23 -4
- package/src/scripts/lint_command_routing.ts +23 -4
- package/src/scripts/lint_command_tiers.ts +23 -2
- package/src/scripts/lint_command_verbs.ts +23 -4
- package/src/scripts/lint_commit_subjects.ts +24 -4
- package/src/scripts/lint_confusables.ts +25 -5
- package/src/scripts/lint_context_spine_usage.ts +23 -4
- package/src/scripts/lint_discovery_manifest.ts +23 -4
- package/src/scripts/lint_discovery_vocabulary.ts +23 -4
- package/src/scripts/lint_empty_roadmaps.ts +23 -4
- package/src/scripts/lint_eval_freshness.ts +23 -4
- package/src/scripts/lint_examples.ts +23 -4
- package/src/scripts/lint_explain_trace.ts +23 -4
- package/src/scripts/lint_featured_skills.ts +0 -0
- package/src/scripts/lint_flows.ts +23 -4
- package/src/scripts/lint_framework_leakage.ts +23 -4
- package/src/scripts/lint_frontmatter_boilerplate.ts +23 -4
- package/src/scripts/lint_ghostwriter_source.ts +23 -4
- package/src/scripts/lint_glama_drift.ts +75 -0
- package/src/scripts/lint_global_paths.ts +23 -2
- package/src/scripts/lint_handoffs.ts +23 -4
- package/src/scripts/lint_hidden_unicode.ts +24 -5
- package/src/scripts/lint_hook_concern_budget.ts +23 -4
- package/src/scripts/lint_hook_manifest.ts +23 -2
- package/src/scripts/lint_instruction_smuggling.ts +25 -5
- package/src/scripts/lint_legal_pack.ts +23 -1
- package/src/scripts/lint_load_context.ts +23 -4
- package/src/scripts/lint_marketplace.ts +24 -3
- package/src/scripts/lint_marketplace_install_completeness.ts +23 -4
- package/src/scripts/lint_mcp_config_security.ts +25 -5
- package/src/scripts/lint_mcp_registry_manifest.ts +23 -4
- package/src/scripts/lint_media_policy_linkage.ts +23 -4
- package/src/scripts/lint_missions.ts +23 -4
- package/src/scripts/lint_model_tier_coverage.ts +23 -4
- package/src/scripts/lint_namespace.ts +23 -4
- package/src/scripts/lint_namespace_collisions.ts +23 -4
- package/src/scripts/lint_new_skill_gate.ts +23 -4
- package/src/scripts/lint_no_new_atomic_commands.ts +23 -4
- package/src/scripts/lint_one_off_age.ts +23 -4
- package/src/scripts/lint_orchestration_dsl.ts +23 -4
- package/src/scripts/lint_orchestrator_auto_detect.ts +23 -4
- package/src/scripts/lint_pack_boundaries.ts +23 -4
- package/src/scripts/lint_pack_dependencies.ts +23 -2
- package/src/scripts/lint_pack_first_win.ts +23 -4
- package/src/scripts/lint_pack_risk_class.ts +23 -1
- package/src/scripts/lint_persona_governance.ts +23 -4
- package/src/scripts/lint_positioning.ts +23 -4
- package/src/scripts/lint_profile_overlay_set_only.ts +23 -4
- package/src/scripts/lint_readme_jargon.ts +23 -4
- package/src/scripts/lint_readme_size.ts +23 -4
- package/src/scripts/lint_regression.ts +23 -4
- package/src/scripts/lint_roadmap_blockers.ts +23 -4
- package/src/scripts/lint_roadmap_ci_steps.ts +23 -4
- package/src/scripts/lint_roadmap_complexity.ts +23 -4
- package/src/scripts/lint_roadmap_later_disposition.ts +23 -4
- package/src/scripts/lint_role_experiences.ts +23 -4
- package/src/scripts/lint_rule_interactions.ts +23 -4
- package/src/scripts/lint_rule_tiers.ts +24 -3
- package/src/scripts/lint_showcase_sessions.ts +23 -4
- package/src/scripts/lint_skill_frontmatter_safety.ts +25 -5
- package/src/scripts/lint_skill_originality.ts +23 -4
- package/src/scripts/lint_skill_tools.ts +23 -4
- package/src/scripts/lint_subagent_determinism.ts +23 -4
- package/src/scripts/lint_ticket_buildable.ts +23 -4
- package/src/scripts/lint_topics_yaml.ts +23 -4
- package/src/scripts/lint_trust_coherence.ts +23 -4
- package/src/scripts/lint_value_dashboard.ts +23 -4
- package/src/scripts/lint_workflow_security.ts +23 -4
- package/src/scripts/lint_workspace_boundary.ts +23 -4
- package/src/scripts/mcp_exec/safety_envelope.ts +105 -0
- package/src/scripts/mcp_parity_smoke.ts +23 -2
- package/src/scripts/mcp_registry_submit.sh +14 -3
- package/src/scripts/mcp_render.ts +23 -4
- package/src/scripts/mcp_server/__main__.ts +6 -8
- package/src/scripts/mcp_server/consumer_tool_catalog.json +78 -3
- package/src/scripts/mcp_server/tools.ts +731 -0
- package/src/scripts/mcp_telemetry_health.ts +23 -4
- package/src/scripts/mcp_telemetry_query.ts +23 -4
- package/src/scripts/mcp_telemetry_store.ts +23 -4
- package/src/scripts/measure_augment_budget.ts +23 -1
- package/src/scripts/measure_density.ts +23 -1
- package/src/scripts/measure_frugality_savings.ts +23 -1
- package/src/scripts/measure_markitdown_lift.ts +23 -1
- package/src/scripts/measure_patterns.ts +23 -1
- package/src/scripts/measure_projection_bytes.ts +23 -1
- package/src/scripts/measure_rule_budget.ts +23 -4
- package/src/scripts/measure_skill_reduction.ts +23 -1
- package/src/scripts/memory_hash.ts +24 -2
- package/src/scripts/memory_lookup.ts +24 -2
- package/src/scripts/memory_report.ts +24 -2
- package/src/scripts/memory_signal.ts +24 -2
- package/src/scripts/memory_status.ts +26 -2
- package/src/scripts/migrate_command_suggestions.ts +23 -4
- package/src/scripts/migrate_frontmatter_defaults.ts +23 -4
- package/src/scripts/migration_status.ts +25 -4
- package/src/scripts/mine_missing_guardrails.ts +23 -1
- package/src/scripts/mine_session.ts +23 -1
- package/src/scripts/minimal_safe_diff_hook.ts +24 -3
- package/src/scripts/new_skill.ts +23 -3
- package/src/scripts/onboarding_gate_hook.ts +24 -3
- package/src/scripts/parity/coverage_diff.ts +25 -3
- package/src/scripts/parity/phase_gate.ts +25 -4
- package/src/scripts/parity/replay.ts +25 -3
- package/src/scripts/pattern_share.ts +23 -4
- package/src/scripts/plan_physical_move.ts +23 -4
- package/src/scripts/prediction-pool/poisson_sim.ts +24 -3
- package/src/scripts/prediction-pool/pool_winsim.ts +24 -3
- package/src/scripts/prediction-pool/score_ev.ts +24 -3
- package/src/scripts/print_required_checks.ts +24 -4
- package/src/scripts/probe_host_compliance.ts +23 -2
- package/src/scripts/probe_projection_fidelity.ts +23 -1
- package/src/scripts/probe_skill_registration.ts +24 -2
- package/src/scripts/profile_staleness_hook.ts +24 -3
- package/src/scripts/profile_use.ts +23 -4
- package/src/scripts/project_thin_rules.ts +23 -3
- package/src/scripts/propose_modules_config.ts +23 -4
- package/src/scripts/prototype_lint_contradictions.ts +23 -1
- package/src/scripts/prove_pack_extractable.ts +23 -4
- package/src/scripts/readme_linter.ts +23 -3
- package/src/scripts/redact_hook_capture.ts +23 -4
- package/src/scripts/refine_ticket_detect.ts +23 -4
- package/src/scripts/release.ts +226 -43
- package/src/scripts/render_benchmark_composite.ts +23 -4
- package/src/scripts/render_benchmark_md.ts +23 -4
- package/src/scripts/roadmap_progress_hook.ts +46 -16
- package/src/scripts/run_skill_evals.ts +23 -4
- package/src/scripts/runtime_dispatcher.ts +23 -4
- package/src/scripts/runtime_registry.ts +23 -4
- package/src/scripts/score_skill_selection.ts +23 -1
- package/src/scripts/security_audit_config.ts +24 -5
- package/src/scripts/skill_collision_clusters.ts +23 -4
- package/src/scripts/skill_discovery.ts +23 -4
- package/src/scripts/skill_linter.ts +23 -2
- package/src/scripts/skill_preview.ts +23 -4
- package/src/scripts/skill_tools/audit_persona_coverage.ts +23 -1
- package/src/scripts/skill_tools/audit_user_type_coverage.ts +23 -1
- package/src/scripts/skill_tools/run_block_d_eval.ts +23 -1
- package/src/scripts/skill_tools/score_skill_relevance.ts +23 -1
- package/src/scripts/skill_tools/suggest_skill_for_task.ts +24 -1
- package/src/scripts/skill_usage_collect.ts +23 -4
- package/src/scripts/smoke_path_resolution.ts +23 -4
- package/src/scripts/smoke_quickstart.ts +23 -4
- package/src/scripts/snapshot_agent_outputs.ts +23 -4
- package/src/scripts/spotcheck_thin_root.ts +23 -4
- package/src/scripts/sync_agent_settings.ts +23 -4
- package/src/scripts/sync_github_metadata.ts +23 -4
- package/src/scripts/sync_gitignore.ts +23 -4
- package/src/scripts/telegraph_stats.ts +23 -4
- package/src/scripts/tool_registry.ts +24 -4
- package/src/scripts/trigger_coverage.ts +23 -4
- package/src/scripts/update_counts.ts +23 -4
- package/src/scripts/update_prices.ts +23 -1
- package/src/scripts/validate_agent_settings.ts +23 -4
- package/src/scripts/validate_decision_engine.ts +23 -4
- package/src/scripts/validate_discovery_manifest.ts +23 -4
- package/src/scripts/validate_frontmatter.ts +23 -2
- package/src/scripts/validate_pack_yaml.ts +0 -0
- package/src/scripts/validate_safe_paths.ts +24 -4
- package/src/scripts/validate_telegraph_carveouts.ts +23 -4
- package/src/scripts/verify_before_complete_hook.ts +24 -3
- package/src/scripts/verify_physical_move.ts +23 -4
- package/src/scripts/wrapper_freshness_hook.ts +107 -8
- package/tests/fixtures/hooks/README.md +92 -0
- package/tests/fixtures/hooks/agent_error.json +7 -0
- package/tests/fixtures/hooks/post_tool_use.json +13 -0
- package/tests/fixtures/hooks/pre_compact.json +7 -0
- package/tests/fixtures/hooks/pre_tool_use.json +9 -0
- package/tests/fixtures/hooks/session_end.json +6 -0
- package/tests/fixtures/hooks/session_start.json +6 -0
- package/tests/fixtures/hooks/stop.json +6 -0
- package/tests/fixtures/hooks/user_prompt_submit.json +7 -0
package/docs/mcp-server.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# MCP Server
|
|
2
2
|
|
|
3
|
-
> Status: **experimental** —
|
|
3
|
+
> Status: **experimental** — read-only prompts + resources plus a growing `tools/*` surface (stub-by-default: every catalogued tool name resolves, unimplemented ones return a structured `not_implemented` envelope). Tool coverage and the write/exec unlock path are governed by [`agents/settings/contexts/mcp-coverage-strategy.md`](../agents/settings/contexts/mcp-coverage-strategy.md). Promotion to **beta** is gated on the six criteria in [`docs/contracts/mcp-beta-criteria.md`](contracts/mcp-beta-criteria.md); current gate status: `./agent-config doctor --check mcp-beta-readiness`.
|
|
4
4
|
|
|
5
5
|
`agent-config` ships a built-in [Model Context Protocol](https://modelcontextprotocol.io)
|
|
6
6
|
server that exposes the package's read-only governance surface to MCP-aware
|
|
@@ -20,22 +20,30 @@ coexist:
|
|
|
20
20
|
[`docs/contracts/mcp-cloud-scope.md`](contracts/mcp-cloud-scope.md).
|
|
21
21
|
Wire-parity-checked against the local stdio kernel on every release.
|
|
22
22
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
[`docs/contracts/mcp-phase-1-scope.md`](contracts/mcp-phase-1-scope.md)
|
|
23
|
+
Every implemented tool is either read-only or writes only inside the
|
|
24
|
+
consumer's project tree via a path-guard (`_validateInTreePath`) —
|
|
25
|
+
[`docs/contracts/mcp-phase-1-scope.md`](contracts/mcp-phase-1-scope.md)
|
|
26
|
+
is the scope contract; exec-tier tools (shell-spawning) and network-tier
|
|
27
|
+
tools (billable) are gated behind
|
|
28
|
+
[`agents/settings/contexts/mcp-coverage-strategy.md`](../agents/settings/contexts/mcp-coverage-strategy.md).
|
|
26
29
|
|
|
27
30
|
## What the server exposes
|
|
28
31
|
|
|
29
|
-
| Primitive | URIs | Source |
|
|
30
|
-
|
|
31
|
-
| `prompts/list` + `prompts/get` | `skill.<name>`, `command.<name>` | `dist/agent-src/skills/`, `dist/agent-src/commands/` |
|
|
32
|
-
| `resources/list` + `resources/read` | `rule://<stem>` | `dist/agent-src/rules/` |
|
|
33
|
-
| ↳ | `guideline://<relpath>` | `docs/guidelines/` |
|
|
34
|
-
| ↳ | `context://<relpath>` | `dist/agent-src/contexts/` |
|
|
32
|
+
| Primitive | URIs | Source |
|
|
33
|
+
|---|---|---|
|
|
34
|
+
| `prompts/list` + `prompts/get` | `skill.<name>`, `command.<name>` | `dist/agent-src/skills/`, `dist/agent-src/commands/` |
|
|
35
|
+
| `resources/list` + `resources/read` | `rule://<stem>` | `dist/agent-src/rules/` |
|
|
36
|
+
| ↳ | `guideline://<relpath>` | `docs/guidelines/` |
|
|
37
|
+
| ↳ | `context://<relpath>` | `dist/agent-src/contexts/` |
|
|
38
|
+
| `tools/list` + `tools/call` | see [`agents/settings/contexts/mcp-tool-tier-map.md`](../agents/settings/contexts/mcp-tool-tier-map.md) for the full candidate surface | `src/scripts/mcp_server/consumer_tool_catalog.json` |
|
|
35
39
|
|
|
36
40
|
All resources are served with `mimeType: text/markdown`. Pagination is
|
|
37
41
|
cursor-based (default page size: 100). Hot-reload triggers automatically on
|
|
38
42
|
file mtime changes — edit a rule, reissue `resources/list`, see the update.
|
|
43
|
+
Exact prompt/resource/tool counts drift with every content change — the smoke
|
|
44
|
+
test below reports the live numbers rather than a number pinned in prose.
|
|
45
|
+
_Last verified boot (`task mcp:glama-test`, 2026-07-07): 430 prompts / 232
|
|
46
|
+
resources / 27 tools (18 implemented, 9 stubs — post write/exec cut)._
|
|
39
47
|
|
|
40
48
|
## Setup — one-line install
|
|
41
49
|
|
|
@@ -60,10 +68,9 @@ task mcp:run # maintainer / dev repo
|
|
|
60
68
|
./agent-config mcp:run # consumer projects
|
|
61
69
|
```
|
|
62
70
|
|
|
63
|
-
Both forms launch the TypeScript MCP server over stdio via `tsx`. Use these
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
the config snippets below.
|
|
71
|
+
Both forms launch the TypeScript MCP server over stdio via `tsx`. Use these
|
|
72
|
+
for a manual smoke test — MCP clients (Claude Desktop, Cursor, Zed, Continue)
|
|
73
|
+
launch the server themselves via the config snippets below.
|
|
67
74
|
|
|
68
75
|
## Client configuration
|
|
69
76
|
|
|
@@ -140,8 +147,9 @@ boots cleanly:
|
|
|
140
147
|
|
|
141
148
|
```bash
|
|
142
149
|
./agent-config mcp:run < /dev/null
|
|
143
|
-
# Expect stderr: "mcp-server: loaded N prompts (0 warnings)"
|
|
144
|
-
# "mcp-server: loaded
|
|
150
|
+
# Expect stderr: "mcp-server: loaded N prompts (0 warnings)",
|
|
151
|
+
# "mcp-server: loaded N resources (0 warnings)", and
|
|
152
|
+
# "mcp-server: registered N tools (N implemented, N stubs): [...]"
|
|
145
153
|
```
|
|
146
154
|
|
|
147
155
|
## Troubleshooting
|
|
@@ -155,9 +163,13 @@ boots cleanly:
|
|
|
155
163
|
## Scope
|
|
156
164
|
|
|
157
165
|
- **In scope:** read-only prompts + resources, pagination, hot-reload, stdio
|
|
158
|
-
transport, free-tier client compatibility
|
|
159
|
-
-
|
|
160
|
-
|
|
161
|
-
|
|
166
|
+
transport, free-tier client compatibility, a growing read-only and
|
|
167
|
+
in-tree-write `tools/*` surface (see
|
|
168
|
+
[`agents/settings/contexts/mcp-tool-tier-map.md`](../agents/settings/contexts/mcp-tool-tier-map.md)).
|
|
169
|
+
- **Out of scope:** SSE / native HTTP transport for this server (the
|
|
170
|
+
Cloudflare Worker above is the HTTP bridge instead), shell-exec and
|
|
171
|
+
network-tier tools until the safety envelope in
|
|
172
|
+
[`agents/settings/contexts/mcp-coverage-strategy.md`](../agents/settings/contexts/mcp-coverage-strategy.md)
|
|
173
|
+
ships, signed payloads.
|
|
162
174
|
|
|
163
175
|
← [Architecture](architecture.md) · [MCP config generation (consumer side)](mcp.md)
|
package/docs/proof.md
CHANGED
|
@@ -27,7 +27,7 @@ evidence pointer, or `task check-claims` fails the build.
|
|
|
27
27
|
| Claim | Kind | Evidence | Resolves |
|
|
28
28
|
|---|---|---|---|
|
|
29
29
|
| On a weak host (claude-haiku-4-5) the package produces a significant, placebo-controlled discipline lift on scope/downstream traps; on a strong host the same measurement is a published null — the package transplants discipline a weak model lacks, not model intelligence. | quant | `docs/benchmark.md#weak-host-specific` | ✅ |
|
|
30
|
-
| The lift-carrying essential cut (kernel + downstream-changes) keeps a significant weak-host discipline lift at a fraction of the full load's tokens, and the lift is FAMILY-SCOPED —
|
|
30
|
+
| The lift-carrying essential cut (kernel + downstream-changes) keeps a significant weak-host discipline lift at a fraction of the full load's tokens, and the lift is FAMILY- and HOST-SCOPED — measured on three hosts: claude-haiku-4-5 (weak) shows the family-scoped lift (trapE 0.533→1.000, 7/7 discordant, corpus cost 1.71x); claude-sonnet-4-6 (strong) is a ceiling null; gpt-5-mini (non-Claude weak, codex prompt-prepend surface) FAILED replication with headroom (corpus Δ=+0.024 p=0.70, capability trend n.s. — no harm claimed, injection-surface confound documented). Therefore discipline_profile: auto enables the lift only where measured (vendor-granular unknown_defaults). Non-claims — the balanced router profile was removed after a NULL measurement (p=0.81, n=24); no full-tier recommendation exists; no cross-vendor lift is claimed. | quant | `docs/benchmark.md#REPLICATION FAILED` | ✅ |
|
|
31
31
|
| The whole layer is compiled into host agents with zero runtime daemon. | qual | `docs/contracts/no-runtime-boundary.md#file-first, no-runtime suite` | ✅ |
|
|
32
32
|
| Removes only its own keys from a shared host config (matched by JSON-pointer + SHA-256), never a neighbour tool's entries. | qual | `docs/contracts/install-layout.md#JSON-pointer` | ✅ |
|
|
33
33
|
|
|
@@ -19,8 +19,15 @@ resources. `tools/list` returns two **deprecated stubs**
|
|
|
19
19
|
successors; `tools/call` against either returns `isError=true`. No
|
|
20
20
|
script execution, no FS access, no shell.
|
|
21
21
|
|
|
22
|
-
Full power — the
|
|
23
|
-
|
|
22
|
+
Full power — the implemented tool surface (18 tools as of the 2026-07-07
|
|
23
|
+
write/exec cut: memory, roadmap, capabilities, doctor/conformance,
|
|
24
|
+
telemetry, council-estimate, and the vitest `run_tests` pilot) — requires
|
|
25
|
+
the **local kernel server** (`agent-config mcp:run` on a repo checkout).
|
|
26
|
+
`implemented_on` stays `["stdio"]` for every execution tool, permanently:
|
|
27
|
+
the Worker has no kernel runtime endpoint — it serves a release-pinned
|
|
28
|
+
content snapshot from R2, so there is no process that could run the
|
|
29
|
+
handlers, and the A0-cloud contract's no-execution boundary is a design
|
|
30
|
+
invariant, not a backlog item. See
|
|
24
31
|
[`../contracts/mcp-cloud-scope.md`](../contracts/mcp-cloud-scope.md)
|
|
25
32
|
for the execution-safety boundary and the Phase-7-DEFERRED gate that
|
|
26
33
|
governs any future tool restoration.
|
|
@@ -32,14 +32,20 @@ Either form populates:
|
|
|
32
32
|
## Plugin marketplace (Claude Code 2026+)
|
|
33
33
|
|
|
34
34
|
Claude Code 2026 supports plugin marketplaces via
|
|
35
|
-
`.claude-plugin/marketplace.json`. The package ships one
|
|
36
|
-
|
|
35
|
+
`.claude-plugin/marketplace.json`. The package ships one, so as an
|
|
36
|
+
**additional, optional** surface you can also install the plugin:
|
|
37
37
|
|
|
38
38
|
```bash
|
|
39
|
-
claude plugin
|
|
39
|
+
claude plugin marketplace add event4u-app/agent-config
|
|
40
|
+
claude plugin install agent-config@event4u-agent-config
|
|
40
41
|
```
|
|
41
42
|
|
|
42
|
-
|
|
43
|
+
The npm/curl entrypoints above are a full install on their own — the
|
|
44
|
+
file projection carries the complete skill/command set; the plugin adds
|
|
45
|
+
the namespaced `agent-config:*` surface on top. When the plugin is
|
|
46
|
+
installed, `agent-config upgrade` refreshes it automatically (Claude
|
|
47
|
+
Code otherwise pins it to the install-time git SHA); `agent-config
|
|
48
|
+
doctor --check claude-plugin` reports a stale snapshot.
|
|
43
49
|
|
|
44
50
|
## CLAUDE.md
|
|
45
51
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@event4u/agent-config",
|
|
3
|
-
"version": "8.
|
|
3
|
+
"version": "8.3.0",
|
|
4
4
|
"description": "Universal AI Agent OS — audited skills, governance rules, commands, and templates for AI coding tools (Claude Code, Cursor, Windsurf, Copilot).",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"private": false,
|
|
@@ -39,6 +39,7 @@
|
|
|
39
39
|
"docs/",
|
|
40
40
|
"src/scripts/",
|
|
41
41
|
"src/templates/",
|
|
42
|
+
"tests/fixtures/hooks/",
|
|
42
43
|
"AGENTS.md",
|
|
43
44
|
"CHANGELOG.md",
|
|
44
45
|
"CONTRIBUTING.md",
|
|
@@ -55,7 +56,7 @@
|
|
|
55
56
|
},
|
|
56
57
|
"scripts": {
|
|
57
58
|
"build:cli": "tsc -p tsconfig.json && chmod +x dist/cli/agent-config.js",
|
|
58
|
-
"build:install-bundle": "esbuild src/scripts/install.ts --bundle --platform=node --format=esm --target=node20 --define:__AGENT_CONFIG_BUNDLE__=true --outfile=dist/install/install.mjs",
|
|
59
|
+
"build:install-bundle": "esbuild src/scripts/install.ts --bundle --platform=node --format=esm --target=node20 --define:__AGENT_CONFIG_BUNDLE__=true --outfile=dist/install/install.mjs --banner:js=\"import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);\"",
|
|
59
60
|
"build:ui": "vite build",
|
|
60
61
|
"build:discovery": "./scripts-run src/scripts/build_discovery_manifest --write --strict",
|
|
61
62
|
"build:mcp-manifest": "./scripts-run src/scripts/build_mcp_registry_manifest --write --strict",
|
|
@@ -82,7 +83,6 @@
|
|
|
82
83
|
"eslint": "^9.39.4",
|
|
83
84
|
"happy-dom": "^20.9.0",
|
|
84
85
|
"js-tiktoken": "^1.0.21",
|
|
85
|
-
"tsx": "^4.22.3",
|
|
86
86
|
"typescript": "^5.9.3",
|
|
87
87
|
"vite": "^5.4.21",
|
|
88
88
|
"vitest": "^2.1.9"
|
|
@@ -97,6 +97,7 @@
|
|
|
97
97
|
"js-yaml": "^4.1.0",
|
|
98
98
|
"open": "^10.2.0",
|
|
99
99
|
"preact": "^10.29.0",
|
|
100
|
+
"tsx": "^4.22.3",
|
|
100
101
|
"yaml": "^2.9.0",
|
|
101
102
|
"zod": "^3.25.0",
|
|
102
103
|
"zod-to-json-schema": "^3.25.0"
|
|
@@ -85,17 +85,19 @@ projection:
|
|
|
85
85
|
# package's residual over it is not significant (p=0.37).
|
|
86
86
|
# full = every rule tier (~11.7x tokens). EXPERIMENTAL opt-in only:
|
|
87
87
|
# residual lift over essential not established.
|
|
88
|
-
# auto = resolve per session against host-capabilities.yml —
|
|
89
|
-
#
|
|
88
|
+
# auto = resolve per session against host-capabilities.yml — measured
|
|
89
|
+
# NULL-lift model -> off; unmeasured Claude-family -> essential;
|
|
90
|
+
# unmeasured non-Claude -> off (P2 verdict, vendor-granular).
|
|
90
91
|
#
|
|
91
92
|
# This key WINS over the legacy `rule_loading_tier` below (mapping when
|
|
92
93
|
# absent: minimal->off, balanced->essential, full->full, custom->custom).
|
|
93
|
-
# The installer fills the placeholder per preset
|
|
94
|
-
#
|
|
95
|
-
#
|
|
96
|
-
#
|
|
97
|
-
#
|
|
98
|
-
#
|
|
94
|
+
# The installer fills the placeholder per preset: minimal->off,
|
|
95
|
+
# balanced->auto, full->full. `auto` is evidence-gated per the P2 verdict
|
|
96
|
+
# (council 2026-07-07): the P2 non-Claude replication FAILED (gpt-5-mini,
|
|
97
|
+
# n=90, docs/benchmark.md), so `auto` enables the lift only where measured
|
|
98
|
+
# — unmeasured Claude-family hosts -> essential (the measured-lift class);
|
|
99
|
+
# measured-null hosts and unmeasured non-Claude hosts -> off
|
|
100
|
+
# (vendor-granular unknown_defaults in src/config/host-capabilities.yml).
|
|
99
101
|
discipline_profile: __DISCIPLINE_PROFILE__
|
|
100
102
|
|
|
101
103
|
# --- Cost profile (legacy knob — superseded by discipline_profile above) ---
|
|
@@ -392,8 +394,9 @@ roadmap:
|
|
|
392
394
|
# per_step = after every completed step (legacy verbose; highest token cost)
|
|
393
395
|
# Trade-off: end_of_roadmap saves tokens and time but lets errors compound
|
|
394
396
|
# across phases. Pick per_phase if the work is risky or unfamiliar.
|
|
395
|
-
#
|
|
396
|
-
#
|
|
397
|
+
# `quality.local_auto_run: false` (the default) suppresses local
|
|
398
|
+
# pipeline runs at EVERY cadence — remote CI is the gate; this knob
|
|
399
|
+
# only matters when `local_auto_run` is `true`.
|
|
397
400
|
quality_cadence: end_of_roadmap
|
|
398
401
|
|
|
399
402
|
# Dashboard regen cadence inside autonomous runs (process-step /
|
|
@@ -444,20 +447,31 @@ roadmap:
|
|
|
444
447
|
# (`task ci`, `make test`, `npm run check`, PHPStan, ECS, Rector,
|
|
445
448
|
# test suites) and whether it waits on remote CI after pushing.
|
|
446
449
|
# Iron Law `verify-before-complete` still applies — when these
|
|
447
|
-
# toggles suppress automatic runs, the agent MUST surface
|
|
448
|
-
#
|
|
449
|
-
#
|
|
450
|
+
# toggles suppress automatic runs, the agent MUST surface the gap
|
|
451
|
+
# in the completion message ("quality gates delegated to remote CI")
|
|
452
|
+
# instead of claiming the tools passed. It never silently claims
|
|
453
|
+
# verification it did not run.
|
|
450
454
|
quality:
|
|
451
455
|
# Run local quality / CI tasks and tests autonomously (true, false)
|
|
452
|
-
#
|
|
453
|
-
#
|
|
454
|
-
#
|
|
456
|
+
# false = default. The agent NEVER runs quality tools or full test
|
|
457
|
+
# suites proactively — and does not ask whether to run them.
|
|
458
|
+
# Toolchains differ per language/project and are often
|
|
459
|
+
# unknown to the agent; discovery + execution costs time and
|
|
460
|
+
# tokens. The user runs quality tools manually; remote CI is
|
|
461
|
+
# the authoritative gate. The agent runs a quality tool ONLY
|
|
462
|
+
# when one of three triggers fires:
|
|
463
|
+
# 1. the user explicitly asks this turn (e.g. /quality-fix),
|
|
464
|
+
# 2. CI / the remote pipeline reports a concrete failure —
|
|
465
|
+
# then run exactly that failing check to reproduce + fix,
|
|
466
|
+
# 3. the new-gate carve-out below.
|
|
467
|
+
# true = opt-in legacy behaviour: agent runs the quality pipeline
|
|
468
|
+
# whenever work is ready for verification, without asking.
|
|
455
469
|
#
|
|
456
470
|
# Carve-out (always runs regardless of this flag): when the change
|
|
457
471
|
# introduces a NEW CI gate, smoke test, or test file, the agent
|
|
458
472
|
# MUST execute it locally to prove the gate works. Without that
|
|
459
473
|
# execution the new gate is unverified evidence.
|
|
460
|
-
local_auto_run:
|
|
474
|
+
local_auto_run: false
|
|
461
475
|
|
|
462
476
|
# Wait for remote CI to finish on the PR / pipeline (true, false)
|
|
463
477
|
# true = after push, poll GitHub check-runs / pipeline status and
|
|
@@ -1,31 +1,40 @@
|
|
|
1
1
|
# Host-capability facts for `discipline_profile: auto` resolution.
|
|
2
2
|
#
|
|
3
3
|
# EVIDENCE-GATED NULL-LIFT DISABLE-LIST — not a model taxonomy.
|
|
4
|
-
# Council
|
|
4
|
+
# Council locks (claude-sonnet-4-5 + gpt-4o, 2026-07-07, recorded in
|
|
5
5
|
# agents/settings/contexts/weak-host-lift-tiering-verdict.md): entries here
|
|
6
|
-
# name ONLY host models with a MEASURED null discipline lift
|
|
7
|
-
#
|
|
8
|
-
#
|
|
9
|
-
# per family, per glob) are FORBIDDEN: they rot at model-release cadence and
|
|
10
|
-
# encode certainty no measurement backs.
|
|
6
|
+
# name ONLY host models with a MEASURED null discipline lift. Speculative
|
|
7
|
+
# strong/weak classifications of unmeasured models are FORBIDDEN: they rot
|
|
8
|
+
# at model-release cadence and encode certainty no measurement backs.
|
|
11
9
|
#
|
|
12
10
|
# Entry contract — every entry carries either:
|
|
13
11
|
# - measured: <report date · pinned report · N pairs> (CLAIMS-grade), or
|
|
14
12
|
# - extrapolated: true + rationale (explicit maintainer
|
|
15
|
-
# judgement, labeled as such
|
|
16
|
-
# measured-null model). Never an unlabeled assumption.
|
|
13
|
+
# judgement, labeled as such). Never an unlabeled assumption.
|
|
17
14
|
#
|
|
18
15
|
# Matching: exact model-id prefix match against the session's model id
|
|
19
16
|
# (vendor-neutral — Claude, GPT, Gemini, open-source ids all welcome once
|
|
20
|
-
# measured).
|
|
21
|
-
#
|
|
22
|
-
# Fail-safe direction: `unknown_default: lift_enabled` means a new or
|
|
23
|
-
# unmeasured model gets the `essential` discipline tier — it costs ~3x tokens
|
|
24
|
-
# on a host that turns out strong, but never silently drops the measured
|
|
25
|
-
# lift on a weak one. The list only ever GROWS by measurement.
|
|
17
|
+
# measured).
|
|
26
18
|
|
|
27
19
|
lift_disabled_models:
|
|
28
20
|
- id: claude-sonnet-4-6
|
|
29
|
-
measured: "2026-07-05 · internal/bench/reports/ab-v2/2026-07-05T07-00-31Z-ab-v2-paired.json · n=84 pairs, full 30-task corpus, discipline Δ=+0.000 (p=1.0)"
|
|
21
|
+
measured: "2026-07-05 · internal/bench/reports/ab-v2/2026-07-05T07-00-31Z-ab-v2-paired.json · n=84 pairs, full 30-task corpus, discipline Δ=+0.000 (p=1.0) — ceiling null"
|
|
22
|
+
- id: gpt-5-mini
|
|
23
|
+
measured: "2026-07-07 · internal/bench/reports/ab-v2/2026-07-07T10-33-53Z-ab-v2-paired.json · n=90 pairs, full 30-task corpus via codex prompt-prepend injection — replication FAILED with headroom (corpus Δ=+0.024 p=0.70; trapE family 0.733→0.667). NOT a validated harm claim (capability trend 89%→82% is n.s., p=0.07). Injection-surface confound documented in docs/benchmark.md."
|
|
30
24
|
|
|
31
|
-
|
|
25
|
+
# Resolution for UNMEASURED models, per vendor family — the P2-verdict
|
|
26
|
+
# council (2026-07-07, 2-round debate) replaced the earlier blanket
|
|
27
|
+
# `lift_enabled` fail-safe: the evidence ledger is now 1 measured lift
|
|
28
|
+
# (Claude weak class) vs 2 measured nulls (Claude strong ceiling; GPT weak
|
|
29
|
+
# failed replication), so unknown non-Claude hosts default OFF (the lift
|
|
30
|
+
# costs 1.2-1.7x and has no measured benefit off-Claude as shipped), while
|
|
31
|
+
# unknown Claude-family hosts keep the fail-safe toward the one measured
|
|
32
|
+
# lift. This is evidence-structure granularity (WHERE measurements exist),
|
|
33
|
+
# not a strength taxonomy; it grows/changes only by measurement.
|
|
34
|
+
#
|
|
35
|
+
# Family detection: model-id prefix. `claude-` -> anthropic; everything
|
|
36
|
+
# else resolves via `default`. Legacy single-value `unknown_default` keys
|
|
37
|
+
# are still read by the resolver (mapped onto `default`).
|
|
38
|
+
unknown_defaults:
|
|
39
|
+
anthropic: lift_enabled
|
|
40
|
+
default: lift_disabled
|
|
@@ -9,9 +9,11 @@
|
|
|
9
9
|
|
|
10
10
|
rule_loading_tier=balanced
|
|
11
11
|
|
|
12
|
-
; Successor knob (ADR-110)
|
|
13
|
-
;
|
|
14
|
-
|
|
12
|
+
; Successor knob (ADR-110). P2-verdict council 2026-07-07: balanced-heritage
|
|
13
|
+
; installs get `auto` — the lift enables only where measured (unmeasured
|
|
14
|
+
; Claude-family hosts -> essential; measured-null and unmeasured non-Claude
|
|
15
|
+
; hosts -> off, per src/config/host-capabilities.yml).
|
|
16
|
+
discipline_profile=auto
|
|
15
17
|
|
|
16
18
|
; Chat history (crash recovery) — balanced = phase-level traceability
|
|
17
19
|
chat_history_frequency=per_phase
|
|
@@ -326,10 +326,29 @@ export function main(argv: string[] | null = null): number {
|
|
|
326
326
|
|
|
327
327
|
// --- CLI entry ---
|
|
328
328
|
|
|
329
|
-
|
|
330
|
-
process.argv[1]
|
|
331
|
-
|
|
332
|
-
|
|
329
|
+
function _isCliEntry(): boolean {
|
|
330
|
+
if (process.argv[1] === undefined) {
|
|
331
|
+
return false;
|
|
332
|
+
}
|
|
333
|
+
const argvUrl = pathToFileURL(path.resolve(process.argv[1])).href;
|
|
334
|
+
if (import.meta.url === argvUrl) {
|
|
335
|
+
return true;
|
|
336
|
+
}
|
|
337
|
+
// A symlinked invocation (e.g. via an installed `.augment/` projection,
|
|
338
|
+
// or macOS /var → /private/var temp dirs) makes the raw URLs differ:
|
|
339
|
+
// import.meta.url is the resolved real path while argv[1] keeps the
|
|
340
|
+
// symlink path. Compare realpaths so the entry guard still fires
|
|
341
|
+
// (without this the CLI silently no-ops when run through a symlink).
|
|
342
|
+
try {
|
|
343
|
+
const here = fs.realpathSync(fileURLToPath(import.meta.url));
|
|
344
|
+
const argv = fs.realpathSync(path.resolve(process.argv[1]));
|
|
345
|
+
return here === argv;
|
|
346
|
+
} catch {
|
|
347
|
+
return false;
|
|
348
|
+
}
|
|
349
|
+
}
|
|
350
|
+
|
|
351
|
+
if (_isCliEntry() || process.argv[1] === _HERE) {
|
|
333
352
|
try {
|
|
334
353
|
process.exitCode = main(process.argv.slice(2));
|
|
335
354
|
} catch (e) {
|
|
@@ -697,10 +697,29 @@ function main(argv: string[] | null = null): number {
|
|
|
697
697
|
|
|
698
698
|
// --- CLI entry ---
|
|
699
699
|
|
|
700
|
-
|
|
701
|
-
process.argv[1]
|
|
702
|
-
|
|
703
|
-
|
|
700
|
+
function _isCliEntry(): boolean {
|
|
701
|
+
if (process.argv[1] === undefined) {
|
|
702
|
+
return false;
|
|
703
|
+
}
|
|
704
|
+
const argvUrl = pathToFileURL(path.resolve(process.argv[1])).href;
|
|
705
|
+
if (import.meta.url === argvUrl) {
|
|
706
|
+
return true;
|
|
707
|
+
}
|
|
708
|
+
// A symlinked invocation (e.g. via an installed `.augment/` projection,
|
|
709
|
+
// or macOS /var → /private/var temp dirs) makes the raw URLs differ:
|
|
710
|
+
// import.meta.url is the resolved real path while argv[1] keeps the
|
|
711
|
+
// symlink path. Compare realpaths so the entry guard still fires
|
|
712
|
+
// (without this the CLI silently no-ops when run through a symlink).
|
|
713
|
+
try {
|
|
714
|
+
const here = fs.realpathSync(fileURLToPath(import.meta.url));
|
|
715
|
+
const argv = fs.realpathSync(path.resolve(process.argv[1]));
|
|
716
|
+
return here === argv;
|
|
717
|
+
} catch {
|
|
718
|
+
return false;
|
|
719
|
+
}
|
|
720
|
+
}
|
|
721
|
+
|
|
722
|
+
if (_isCliEntry() || process.argv[1] === _HERE) {
|
|
704
723
|
try {
|
|
705
724
|
process.exitCode = main(process.argv.slice(2));
|
|
706
725
|
} catch (e) {
|