@event4u/agent-config 3.3.0 → 4.1.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/.agent-src/README.md +2 -2
- package/.agent-src/commands/agent-handoff.md +31 -2
- package/.agent-src/commands/agent-status.md +5 -5
- package/.agent-src/commands/agents/audit.md +8 -8
- package/.agent-src/commands/agents/init.md +25 -1
- package/.agent-src/commands/agents/optimize.md +3 -3
- package/.agent-src/commands/agents/user.md +1 -1
- package/.agent-src/commands/agents.md +1 -1
- package/.agent-src/commands/analyze-reference-repo.md +1 -1
- package/.agent-src/commands/check-current-md.md +8 -8
- package/.agent-src/commands/{compress.md → condense.md} +55 -55
- package/.agent-src/commands/context/create.md +7 -4
- package/.agent-src/commands/context/refactor.md +3 -1
- package/.agent-src/commands/feature/dev.md +1 -1
- package/.agent-src/commands/feature/explore.md +1 -1
- package/.agent-src/commands/feature/plan.md +10 -8
- package/.agent-src/commands/feature/refactor.md +3 -1
- package/.agent-src/commands/feature/roadmap.md +7 -4
- package/.agent-src/commands/fix/portability.md +3 -3
- package/.agent-src/commands/fix/refs.md +4 -4
- package/.agent-src/commands/ghostwriter.md +2 -2
- package/.agent-src/commands/memory/learn-low-impact.md +3 -3
- package/.agent-src/commands/module/explore.md +34 -8
- package/.agent-src/commands/optimize/agents-dir.md +9 -7
- package/.agent-src/commands/optimize/augmentignore.md +2 -2
- package/.agent-src/commands/optimize/skills.md +9 -9
- package/.agent-src/commands/post-as.md +1 -1
- package/.agent-src/commands/project-analyze.md +2 -2
- package/.agent-src/commands/project-health.md +3 -2
- package/.agent-src/commands/research/deep.md +1 -1
- package/.agent-src/commands/research/report.md +1 -1
- package/.agent-src/commands/research.md +1 -1
- package/.agent-src/commands/roadmap/ai-council.md +1 -1
- package/.agent-src/commands/roadmap/create.md +9 -4
- package/.agent-src/commands/rule-compliance-audit.md +1 -1
- package/.agent-src/commands/upstream-contribute.md +14 -14
- package/.agent-src/commands/video/from-script.md +1 -1
- package/.agent-src/commands/video/scene.md +1 -1
- package/.agent-src/commands/video/stitch.md +1 -1
- package/.agent-src/commands/video/storyboard.md +1 -1
- package/.agent-src/commands/video.md +1 -1
- package/.agent-src/contexts/augment-infrastructure.md +1 -1
- package/.agent-src/contexts/authority/commit-mechanics.md +15 -0
- package/.agent-src/contexts/authority/kernel-rule-edits.md +3 -3
- package/.agent-src/contexts/authority/scope-mechanics.md +1 -1
- package/.agent-src/contexts/communication/rules-auto/augment-source-of-truth-mechanics.md +28 -28
- package/.agent-src/contexts/communication/rules-auto/skill-quality-mechanics.md +4 -4
- package/.agent-src/contexts/communication/rules-auto/think-before-action-mechanics.md +2 -2
- package/.agent-src/contexts/contracts/artifact-engagement-flow.md +6 -6
- package/.agent-src/contexts/contracts/command-suggestion-flow.md +3 -3
- package/.agent-src/contexts/contracts/emergency-triage-block.md +4 -4
- package/.agent-src/contexts/contracts/frugality-charter.md +3 -3
- package/.agent-src/contexts/documentation-hierarchy.md +14 -7
- package/.agent-src/contexts/execution/autonomy-examples.md +1 -1
- package/.agent-src/contexts/execution/cheap-question-mechanics.md +39 -2
- package/.agent-src/contexts/execution/roadmap-process-loop.md +28 -5
- package/.agent-src/contexts/override-system.md +5 -5
- package/.agent-src/ghostwriter/fictional-fixture-v1.md +1 -1
- package/.agent-src/personas/advisors/first-principles.md +1 -1
- package/.agent-src/personas/hollywood-director.md +1 -1
- package/.agent-src/rules/architecture.md +5 -1
- package/.agent-src/rules/augment-edit-discipline.md +5 -5
- package/.agent-src/rules/augment-source-of-truth.md +15 -15
- package/.agent-src/rules/commit-conventions.md +1 -1
- package/.agent-src/rules/commit-policy.md +10 -0
- package/.agent-src/rules/domain-adoption-policy.md +3 -3
- package/.agent-src/rules/fast-path-marker-visibility.md +3 -3
- package/.agent-src/rules/finance-safety-floor.md +1 -1
- package/.agent-src/rules/framework-neutrality-in-generic-skills.md +8 -8
- package/.agent-src/rules/git-history-discipline.md +1 -1
- package/.agent-src/rules/improve-before-implement.md +2 -2
- package/.agent-src/rules/language-and-tone.md +2 -2
- package/.agent-src/rules/media-governance-routing.md +5 -5
- package/.agent-src/rules/no-attribution-footers.md +1 -0
- package/.agent-src/rules/no-cheap-questions.md +3 -0
- package/.agent-src/rules/no-decorative-emojis-in-git-surfaces.md +111 -0
- package/.agent-src/rules/no-pr-progress-comments.md +118 -0
- package/.agent-src/rules/no-roadmap-references.md +3 -3
- package/.agent-src/rules/non-destructive-by-default.md +1 -1
- package/.agent-src/rules/persona-governance.md +3 -3
- package/.agent-src/rules/preservation-guard.md +15 -15
- package/.agent-src/rules/roadmap-ci-steps-policy.md +7 -3
- package/.agent-src/rules/rule-type-governance.md +1 -1
- package/.agent-src/rules/skill-quality.md +1 -1
- package/.agent-src/rules/{caveman-speak.md → telegraph-speak.md} +15 -15
- package/.agent-src/rules/token-optimizer-maintenance.md +6 -6
- package/.agent-src/skills/agent-docs-writing/SKILL.md +17 -11
- package/.agent-src/skills/agents-md-thin-root/SKILL.md +9 -9
- package/.agent-src/skills/check-refs/SKILL.md +2 -2
- package/.agent-src/skills/code-refactoring/SKILL.md +2 -2
- package/.agent-src/skills/command-writing/SKILL.md +19 -19
- package/.agent-src/skills/comp-banding/SKILL.md +1 -1
- package/.agent-src/skills/condense-memory/SKILL.md +131 -0
- package/.agent-src/skills/context-authoring/SKILL.md +2 -2
- package/.agent-src/skills/context-document/SKILL.md +5 -3
- package/.agent-src/skills/copilot-agents-optimization/SKILL.md +3 -3
- package/.agent-src/skills/description-assist/SKILL.md +2 -2
- package/.agent-src/skills/git-workflow/SKILL.md +1 -1
- package/.agent-src/skills/guideline-writing/SKILL.md +5 -5
- package/.agent-src/skills/learning-to-rule-or-skill/SKILL.md +4 -4
- package/.agent-src/skills/lint-skills/SKILL.md +3 -3
- package/.agent-src/skills/md-language-check/SKILL.md +2 -2
- package/.agent-src/skills/module-detect-on-the-fly/SKILL.md +138 -0
- package/.agent-src/skills/module-management/SKILL.md +166 -94
- package/.agent-src/skills/override-management/SKILL.md +1 -1
- package/.agent-src/skills/persona-writing/SKILL.md +5 -5
- package/.agent-src/skills/positioning-strategy/SKILL.md +1 -1
- package/.agent-src/skills/project-docs/SKILL.md +6 -4
- package/.agent-src/skills/readme-reviewer/SKILL.md +2 -2
- package/.agent-src/skills/roadmap-management/SKILL.md +13 -1
- package/.agent-src/skills/roadmap-writing/SKILL.md +4 -2
- package/.agent-src/skills/rule-refactor/SKILL.md +5 -5
- package/.agent-src/skills/rule-writing/SKILL.md +18 -18
- package/.agent-src/skills/script-writing/SKILL.md +1 -1
- package/.agent-src/skills/skill-improvement-pipeline/SKILL.md +6 -6
- package/.agent-src/skills/skill-management/SKILL.md +21 -21
- package/.agent-src/skills/skill-reviewer/SKILL.md +2 -2
- package/.agent-src/skills/skill-writing/SKILL.md +8 -8
- package/.agent-src/skills/skill-writing/evals/triggers.json +1 -1
- package/.agent-src/skills/token-optimizer/SKILL.md +4 -4
- package/.agent-src/skills/unit-economics-modeling/SKILL.md +1 -1
- package/.agent-src/skills/upstream-contribute/SKILL.md +17 -17
- package/.agent-src/templates/AGENTS.md +1 -0
- package/.agent-src/templates/agent-settings.md +24 -13
- package/.agent-src/templates/agents/agent-project-settings.example.yml +61 -2
- package/.agent-src/templates/command.md +5 -5
- package/.agent-src/templates/contexts.md +1 -1
- package/.agent-src/templates/copilot-instructions.md +8 -8
- package/.agent-src/templates/features.md +1 -1
- package/.agent-src/templates/hooks/pre-commit-frontmatter +2 -2
- package/.agent-src/templates/hooks/pre-commit-roadmap-progress +3 -3
- package/.agent-src/templates/persona.md +2 -2
- package/.agent-src/templates/roadmaps.md +1 -1
- package/.agent-src/templates/rule.md +13 -13
- package/.agent-src/templates/scripts/memory_lookup.py +1 -1
- package/.agent-src/templates/scripts/memory_status.py +2 -2
- package/.agent-src/templates/scripts/work_engine/_lib/agent_settings.py +195 -1
- package/.agent-src/templates/scripts/work_engine/orchestration.py +1 -1
- package/.agent-src/templates/skill-archive-note.md +5 -5
- package/.agent-src/templates/skill.md +1 -1
- package/.claude-plugin/marketplace.json +4 -4
- package/AGENTS.md +16 -17
- package/CHANGELOG.md +181 -3
- package/CONTRIBUTING.md +31 -12
- package/README.md +18 -10
- package/config/agent-settings.template.yml +22 -2
- package/config/discovery/unassigned-artefacts.yml +24 -24
- package/config/profiles/full.ini +1 -1
- package/dist/cli/agent-config.js +52 -3
- package/dist/cli/agent-config.js.map +1 -1
- package/dist/cli/commands/uiServe.js +9 -0
- package/dist/cli/commands/uiServe.js.map +1 -1
- package/dist/cli/registry.js +2 -1
- package/dist/cli/registry.js.map +1 -1
- package/dist/discovery/deprecation-report.md +1 -1
- package/dist/discovery/discovery-manifest.json +649 -606
- package/dist/discovery/discovery-manifest.json.sha256 +1 -1
- package/dist/discovery/discovery-manifest.summary.md +4 -4
- package/dist/discovery/orphan-report.md +1 -1
- package/dist/discovery/packs.json +439 -437
- package/dist/discovery/trust-report.md +5 -5
- package/dist/discovery/workspaces.json +450 -448
- package/dist/install/apply.js +238 -0
- package/dist/install/apply.js.map +1 -0
- package/dist/install/atomic.js +92 -0
- package/dist/install/atomic.js.map +1 -0
- package/dist/install/bridges/augment.js +20 -0
- package/dist/install/bridges/augment.js.map +1 -0
- package/dist/install/bridges/claude.js +44 -0
- package/dist/install/bridges/claude.js.map +1 -0
- package/dist/install/bridges/cline.js +69 -0
- package/dist/install/bridges/cline.js.map +1 -0
- package/dist/install/bridges/copilot.js +28 -0
- package/dist/install/bridges/copilot.js.map +1 -0
- package/dist/install/bridges/cursor.js +34 -0
- package/dist/install/bridges/cursor.js.map +1 -0
- package/dist/install/bridges/gemini.js +39 -0
- package/dist/install/bridges/gemini.js.map +1 -0
- package/dist/install/bridges/index.js +88 -0
- package/dist/install/bridges/index.js.map +1 -0
- package/dist/install/bridges/marker-content.js +153 -0
- package/dist/install/bridges/marker-content.js.map +1 -0
- package/dist/install/bridges/markers.js +42 -0
- package/dist/install/bridges/markers.js.map +1 -0
- package/dist/install/bridges/types.js +31 -0
- package/dist/install/bridges/types.js.map +1 -0
- package/dist/install/bridges/vscode.js +26 -0
- package/dist/install/bridges/vscode.js.map +1 -0
- package/dist/install/bridges/windsurf.js +35 -0
- package/dist/install/bridges/windsurf.js.map +1 -0
- package/dist/install/conflict.js +196 -0
- package/dist/install/conflict.js.map +1 -0
- package/dist/install/detect.js +218 -0
- package/dist/install/detect.js.map +1 -0
- package/dist/install/paths.js +82 -0
- package/dist/install/paths.js.map +1 -0
- package/dist/install/plan.js +157 -0
- package/dist/install/plan.js.map +1 -0
- package/dist/install/txlog.js +140 -0
- package/dist/install/txlog.js.map +1 -0
- package/dist/install/types.js +19 -0
- package/dist/install/types.js.map +1 -0
- package/dist/install/wizard-plan.js +184 -0
- package/dist/install/wizard-plan.js.map +1 -0
- package/dist/mcp/registry-manifest.json +4 -4
- package/dist/router.json +67 -19
- package/dist/server/app.js +6 -0
- package/dist/server/app.js.map +1 -1
- package/dist/server/routes/install.js +547 -0
- package/dist/server/routes/install.js.map +1 -0
- package/dist/server/routes/wizard.js +301 -6
- package/dist/server/routes/wizard.js.map +1 -1
- package/dist/server/routes/workspace.js +396 -0
- package/dist/server/routes/workspace.js.map +1 -0
- package/dist/server/schemas/settings.js +4 -3
- package/dist/server/schemas/settings.js.map +1 -1
- package/dist/ui/assets/index-BXZILUxe.css +1 -0
- package/dist/ui/assets/index-DLEuEW1V.js +35 -0
- package/dist/ui/assets/index-DLEuEW1V.js.map +1 -0
- package/dist/ui/index.html +2 -2
- package/docs/MIGRATION.md +1 -1
- package/docs/adrs/cost/0001-hard-stop-hook.md +1 -1
- package/docs/adrs/router/0001-three-tier-routing.md +4 -4
- package/docs/adrs/schema/0001-json-schema-frontmatter.md +1 -1
- package/docs/adrs/smoke/0001-per-tier-smoke-scripts.md +4 -4
- package/docs/adrs/{caveman → telegraph}/0001-default-off-until-bench.md +9 -9
- package/docs/adrs/telegraph/README.md +9 -0
- package/docs/architecture/augment-projection.md +4 -4
- package/docs/architecture/claude-bundle.md +1 -1
- package/docs/architecture/current-onboard-baseline.md +3 -3
- package/docs/architecture/multi-tool-projection.md +10 -10
- package/docs/architecture/source-projection.md +27 -27
- package/docs/architecture.md +19 -15
- package/docs/archive/CHANGELOG-pre-2.11.0.md +2 -2
- package/docs/archive/CHANGELOG-pre-2.15.0.md +3 -3
- package/docs/archive/CHANGELOG-pre-2.16.0.md +1 -1
- package/docs/archive/CHANGELOG-pre-2.2.0.md +70 -70
- package/docs/archive/CHANGELOG-pre-2.20.0.md +2 -2
- package/docs/archive/CHANGELOG-pre-2.25.0.md +15 -15
- package/docs/archive/CHANGELOG-pre-3.0.0.md +4 -4
- package/docs/archive/CHANGELOG-pre-3.1.0.md +2 -2
- package/docs/archive/CHANGELOG-pre-3.2.0.md +3 -3
- package/docs/benchmark.md +65 -0
- package/docs/benchmarks.md +16 -16
- package/docs/catalog.md +17 -15
- package/docs/contracts/CHANGELOG-conventions.md +1 -1
- package/docs/contracts/STABILITY.md +2 -2
- package/docs/contracts/adoption-signal-floor.md +110 -0
- package/docs/contracts/adr-chat-history-split.md +4 -4
- package/docs/contracts/adr-command-suggestion.md +4 -4
- package/docs/contracts/adr-gtm-context-spine.md +1 -1
- package/docs/contracts/adr-implement-ticket-runtime.md +4 -4
- package/docs/contracts/adr-install-user-type-axis.md +1 -1
- package/docs/contracts/adr-layout.md +2 -2
- package/docs/contracts/adr-product-ui-track.md +10 -10
- package/docs/contracts/adr-user-types-axis.md +3 -3
- package/docs/contracts/adr-wing4-context-spine.md +1 -1
- package/docs/contracts/agent-memory-contract.md +3 -3
- package/docs/contracts/agents-md-tech-stack.md +2 -2
- package/docs/contracts/ai-council-config.md +2 -2
- package/docs/contracts/at-rest-encryption.md +4 -0
- package/docs/contracts/audit-log-v1.md +1 -1
- package/docs/contracts/benchmark-ab-contract.md +101 -0
- package/docs/contracts/benchmark-corpus-spec.md +1 -1
- package/docs/contracts/branch-protection-policy.md +98 -0
- package/docs/contracts/ci-cost-budget.md +106 -0
- package/docs/contracts/ci-green-floor.md +141 -0
- package/docs/contracts/command-clusters.md +6 -6
- package/docs/contracts/command-surface-tiers.md +2 -2
- package/docs/contracts/command-taxonomy.md +2 -2
- package/docs/contracts/{compression-default-kill-criterion.md → condensation-default-kill-criterion.md} +29 -29
- package/docs/contracts/config-presets.md +1 -1
- package/docs/contracts/context-paths.md +3 -3
- package/docs/contracts/context-spine.md +1 -1
- package/docs/contracts/cost-summary-schema.md +12 -12
- package/docs/contracts/cross-wing-handoff.md +4 -4
- package/docs/contracts/daily-workspace.md +4 -0
- package/docs/contracts/decision-trace-v1.md +2 -2
- package/docs/contracts/discovery-manifest.md +4 -4
- package/docs/contracts/explain-modes.md +4 -0
- package/docs/contracts/file-ownership-matrix.json +3493 -3318
- package/docs/contracts/file-ownership-matrix.md +3 -3
- package/docs/contracts/frontmatter-contract.md +4 -4
- package/docs/contracts/ghostwriter-schema.md +3 -3
- package/docs/contracts/gui-wizard.md +1 -1
- package/docs/contracts/harness-expectations.md +123 -0
- package/docs/contracts/host-agent-protocol.md +4 -0
- package/docs/contracts/implement-ticket-flow.md +9 -9
- package/docs/contracts/install-scopes.md +77 -0
- package/docs/contracts/iron-law-overrides.txt +1 -1
- package/docs/contracts/kernel-membership.md +26 -26
- package/docs/contracts/linear-ai-rules-inclusion.md +1 -1
- package/docs/contracts/linter-structural-model.md +2 -2
- package/docs/contracts/load-context-budget-model.md +4 -4
- package/docs/contracts/load-context-schema.md +13 -13
- package/docs/contracts/local-analytics.md +4 -0
- package/docs/contracts/local-knowledge-ingestion.md +1 -1
- package/docs/contracts/mcp-cloud-scope.md +2 -2
- package/docs/contracts/mcp-phase-1-scope.md +3 -3
- package/docs/contracts/measurement-baseline.md +5 -5
- package/docs/contracts/mental-models.md +30 -30
- package/docs/contracts/multi-tool-projection-fidelity.md +4 -4
- package/docs/contracts/namespace.md +4 -4
- package/docs/contracts/orchestration-dsl-v1.md +7 -7
- package/docs/contracts/package-self-orientation.md +12 -12
- package/docs/contracts/persona-schema.md +6 -6
- package/docs/contracts/pilot/language-and-tone.md +1 -1
- package/docs/contracts/plain-language-surface.md +117 -0
- package/docs/contracts/profile-system.md +3 -3
- package/docs/contracts/release-pr-gating.md +103 -0
- package/docs/contracts/role-experience.md +3 -3
- package/docs/contracts/rule-classification.md +13 -13
- package/docs/contracts/rule-interactions.md +4 -4
- package/docs/contracts/rule-interactions.yml +30 -30
- package/docs/contracts/rule-priority-hierarchy.md +13 -13
- package/docs/contracts/rule-router.md +2 -2
- package/docs/contracts/safety-model.md +1 -1
- package/docs/contracts/skill-distribution-channels.md +61 -0
- package/docs/contracts/skill-domains.md +2 -2
- package/docs/contracts/smoke-contracts.md +5 -5
- package/docs/contracts/telegraph-telemetry.md +83 -0
- package/docs/contracts/trust-and-safety.md +5 -5
- package/docs/contracts/ui-stack-extension.md +7 -7
- package/docs/contracts/ui-track-flow.md +9 -9
- package/docs/contracts/user-type-schema.md +4 -4
- package/docs/contracts/workflow-packs.md +4 -4
- package/docs/contracts/workspace-documents.md +4 -0
- package/docs/customization.md +28 -8
- package/docs/decisions/ADR-001-kernel-swap-deferred.md +6 -6
- package/docs/decisions/ADR-002-kernel-bucket-overrides.md +11 -11
- package/docs/decisions/ADR-003-flat-cluster-subs-and-colon-syntax.md +2 -2
- package/docs/decisions/ADR-004-rule-governance-pruning.md +4 -4
- package/docs/decisions/ADR-005-subagent-worktrees.md +7 -7
- package/docs/decisions/ADR-011-domain-pack-readiness.md +6 -6
- package/docs/decisions/ADR-013-discovery-frontmatter-contract.md +3 -3
- package/docs/decisions/ADR-015-discovery-manifest-contract.md +3 -3
- package/docs/decisions/ADR-017-monorepo-physical-layout.md +10 -10
- package/docs/decisions/ADR-018-trust-and-safety-layer.md +6 -6
- package/docs/decisions/ADR-019-router-json-dist-location.md +2 -2
- package/docs/decisions/ADR-020-global-only-consumer-scope.md +2 -2
- package/docs/decisions/ADR-021-deployment-shape.md +1 -1
- package/docs/decisions/ADR-022-daily-workspace-decomposition.md +1 -1
- package/docs/decisions/ADR-027-changelog-machine-vs-manual.md +2 -2
- package/docs/decisions/ADR-028-root-layout.md +7 -7
- package/docs/decisions/ADR-029-multi-workspace-deferred.md +2 -2
- package/docs/decisions/ADR-rule-kernel-and-router.md +5 -5
- package/docs/deploy/team-deployment-posture.md +20 -0
- package/docs/development.md +17 -17
- package/docs/distribution/registries.md +32 -0
- package/docs/distribution/registry-submissions.md +85 -0
- package/docs/distribution/telemetry-schema.md +1 -1
- package/docs/getting-started-by-role.md +45 -3
- package/docs/getting-started.md +2 -2
- package/docs/guidelines/agent-infra/5w2h-analysis.md +3 -3
- package/docs/guidelines/agent-infra/ask-when-uncertain-demos.md +1 -1
- package/docs/guidelines/agent-infra/asking-and-brevity-examples.md +3 -3
- package/docs/guidelines/agent-infra/carve-out-predicates.md +3 -3
- package/docs/guidelines/agent-infra/critical-thinking.md +4 -4
- package/docs/guidelines/agent-infra/direct-answers-demos.md +1 -1
- package/docs/guidelines/agent-infra/first-principles.md +2 -2
- package/docs/guidelines/agent-infra/inversion-thinking.md +5 -5
- package/docs/guidelines/agent-infra/layered-settings.md +56 -2
- package/docs/guidelines/agent-infra/mental-models.md +3 -3
- package/docs/guidelines/agent-infra/roadmap-progress-mechanics.md +2 -2
- package/docs/guidelines/agent-infra/rule-type-governance.md +1 -1
- package/docs/guidelines/agent-infra/scqa-framework.md +5 -5
- package/docs/guidelines/agent-infra/self-improvement-pipeline.md +2 -2
- package/docs/guidelines/agent-infra/six-hats.md +3 -3
- package/docs/guidelines/agent-infra/skill-quality-checklist.md +5 -5
- package/docs/guidelines/agent-infra/systems-thinking.md +1 -1
- package/docs/guidelines/agent-infra/verify-before-complete-demos.md +1 -1
- package/docs/guidelines/augment-portability-patterns.md +4 -4
- package/docs/guidelines/cross-role-handoff.md +2 -2
- package/docs/guidelines/php/php-coding-patterns.md +1 -1
- package/docs/guidelines/prompt-templates.md +6 -6
- package/docs/maintainers/dev-mode.md +1 -1
- package/docs/mcp.md +1 -1
- package/docs/parity/bench.json +3 -3
- package/docs/parity/ruflo.md +2 -2
- package/docs/profiles.md +11 -11
- package/docs/quality.md +11 -11
- package/docs/safety.md +3 -3
- package/docs/setup/mcp-client-config.md +1 -1
- package/docs/setup/mcp-r2-bootstrap.md +1 -1
- package/docs/setup/mcp-server-docker.md +3 -3
- package/docs/setup/per-ide/windsurf.md +1 -1
- package/docs/skills-catalog.md +8 -7
- package/docs/troubleshooting.md +1 -1
- package/docs/walkthroughs/daily-workspace-a11y.md +87 -0
- package/llms.txt +7 -6
- package/package.json +1 -1
- package/scripts/__pycache__/validate_frontmatter.cpython-312.pyc +0 -0
- package/scripts/_archive/README.md +2 -2
- package/scripts/_archive/_backfill_skill_domains.py +3 -3
- package/scripts/_archive/_bootstrap_tier_frontmatter.py +3 -3
- package/scripts/_archive/_p43_bodies.py +10 -10
- package/scripts/_archive/{_p43_compress.py → _p43_condense.py} +5 -5
- package/scripts/_archive/_p4_migrate.py +7 -7
- package/scripts/_archive/_phase2_shim_helper.py +1 -1
- package/scripts/_archive/_pilot_council_question.py +5 -5
- package/scripts/_cli/explain_last/inputs.py +1 -1
- package/scripts/_lib/__pycache__/__init__.cpython-312.pyc +0 -0
- package/scripts/_lib/__pycache__/agent_src.cpython-312.pyc +0 -0
- package/scripts/_lib/agent_settings.py +195 -1
- package/scripts/_lib/agent_src.py +19 -19
- package/scripts/_lib/bench_ab_cache.py +162 -0
- package/scripts/_lib/bench_ab_scoring.py +209 -0
- package/scripts/_lib/{bench_caveman.py → bench_telegraph.py} +21 -21
- package/scripts/_lib/{bench_caveman_report.py → bench_telegraph_report.py} +21 -21
- package/scripts/_lib/claude_desktop_bundler.py +5 -5
- package/scripts/_lib/module_detection.py +223 -0
- package/scripts/_lib/scope_guard.sh +162 -0
- package/scripts/_phase4_bucket.py +3 -3
- package/scripts/_pilot_measure.py +4 -4
- package/scripts/_tmp_scan_framework_leakage.py +1 -1
- package/scripts/adoption_report.py +195 -0
- package/scripts/adoption_snapshot.py +219 -0
- package/scripts/adoption_status.py +166 -0
- package/scripts/ai-video/lib/parse-blueprint.sh +1 -1
- package/scripts/ai_council/advisors.py +5 -5
- package/scripts/ai_council/compile_corpus.py +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_budget_v2_audit.py +3 -3
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_context_layer_v1_review.py +2 -2
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_inject_quiet_flag.py +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_measure_v2.sh +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_measure_verbosity.sh +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_nondestructive_inline_audit.py +3 -3
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_per_task.sh +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase6_trigger_jaccard.py +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase_2a_budget_rebalance.py +6 -6
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_rebalancing_audit.py +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_tier_retrofit.py +6 -6
- package/scripts/annotate_discovery.py +13 -13
- package/scripts/apply_modules_config.py +290 -0
- package/scripts/audit_adr_coverage.py +2 -2
- package/scripts/audit_auto_rules.py +2 -2
- package/scripts/audit_cloud_compatibility.py +3 -3
- package/scripts/audit_command_surface.py +9 -9
- package/scripts/audit_likelihood.py +2 -2
- package/scripts/audit_user_type_axis.py +2 -2
- package/scripts/bench_ab_cache_dispatch.py +68 -0
- package/scripts/bench_ab_clone.py +170 -0
- package/scripts/bench_ab_diff.py +227 -0
- package/scripts/bench_ab_integrity.py +143 -0
- package/scripts/bench_ab_run.py +235 -0
- package/scripts/bench_ab_task_runner.py +369 -0
- package/scripts/bench_ab_tracka_run.py +202 -0
- package/scripts/{bench_compress_memory.py → bench_condense_memory.py} +16 -16
- package/scripts/bench_run.py +33 -33
- package/scripts/bench_runner.py +2 -2
- package/scripts/bootstrap.sh +99 -0
- package/scripts/build_cloud_bundle.py +6 -6
- package/scripts/build_discovery_manifest.py +7 -7
- package/scripts/build_linear_digest.py +3 -3
- package/scripts/build_rule_trigger_matrix.py +8 -8
- package/scripts/chat_history.py +5 -5
- package/scripts/check_always_budget.py +11 -5
- package/scripts/check_augment_description_cap.py +3 -3
- package/scripts/check_cluster_patterns.py +2 -2
- package/scripts/check_command_count_messaging.py +3 -3
- package/scripts/{check_compression.py → check_condensation.py} +34 -34
- package/scripts/{check_compressed_paths.py → check_condensed_paths.py} +8 -8
- package/scripts/check_context_paths.py +7 -7
- package/scripts/check_council_layout.py +2 -2
- package/scripts/check_council_references.py +9 -9
- package/scripts/check_iron_law_prominence.py +2 -2
- package/scripts/check_kernel_rule_bundle.py +2 -2
- package/scripts/check_module_management_neutral.py +149 -0
- package/scripts/check_no_roadmap_refs.py +9 -9
- package/scripts/check_portability.py +3 -3
- package/scripts/check_public_catalog_links.py +4 -4
- package/scripts/check_references.py +7 -6
- package/scripts/check_release_pr_shape.py +112 -0
- package/scripts/check_reply_consistency.py +3 -3
- package/scripts/check_safety_floor_untouched.py +1 -1
- package/scripts/check_template_pin_drift.py +5 -5
- package/scripts/check_token_optimizer_freshness.py +3 -3
- package/scripts/ci_status.py +301 -0
- package/scripts/ci_time_ratio.py +1 -1
- package/scripts/cleanup_other_scope.sh +146 -0
- package/scripts/compile_router.py +10 -10
- package/scripts/{compress.py → condense.py} +64 -64
- package/scripts/condense.sh +18 -0
- package/scripts/{compress_memory.py → condense_memory.py} +33 -33
- package/scripts/config/presets.py +2 -2
- package/scripts/config/profiles.py +1 -1
- package/scripts/cost_by_conversation.py +3 -3
- package/scripts/cost_summary.py +7 -7
- package/scripts/count_token_optimizer_usage.sh +1 -1
- package/scripts/gen_discovery_baseline.py +5 -5
- package/scripts/generate_index.py +6 -6
- package/scripts/generate_ownership_matrix.py +10 -10
- package/scripts/generate_pack_manifests.py +1 -1
- package/scripts/ghostwriter_fixture_allowlist.txt +1 -1
- package/scripts/install +3 -3
- package/scripts/install-hooks.sh +6 -6
- package/scripts/install.py +76 -11
- package/scripts/install.sh +187 -1
- package/scripts/inventory_frontmatter.py +2 -2
- package/scripts/iron_law_sha.py +3 -3
- package/scripts/lint_agents_layout.py +14 -7
- package/scripts/lint_agents_md.py +4 -4
- package/scripts/lint_archived_skills.py +3 -3
- package/scripts/lint_artefact_frontmatter.py +2 -2
- package/scripts/lint_bench_ab.py +172 -0
- package/scripts/lint_bench_corpus.py +1 -1
- package/scripts/lint_command_tiers.py +5 -5
- package/scripts/lint_context_spine_usage.py +1 -1
- package/scripts/lint_framework_leakage.py +7 -7
- package/scripts/lint_framework_leakage_allowlist.json +144 -84
- package/scripts/lint_ghostwriter_source.py +3 -3
- package/scripts/lint_handoffs.py +1 -1
- package/scripts/lint_load_context.py +11 -11
- package/scripts/lint_media_policy_linkage.py +5 -5
- package/scripts/lint_namespace.py +1 -1
- package/scripts/lint_no_new_atomic_commands.py +2 -2
- package/scripts/lint_orchestration_dsl.py +1 -1
- package/scripts/lint_pack_boundaries.py +2 -2
- package/scripts/lint_persona_governance.py +4 -4
- package/scripts/lint_role_experiences.py +237 -0
- package/scripts/lint_rule_interactions.py +2 -2
- package/scripts/lint_rule_tiers.py +1 -1
- package/scripts/lint_trust_coherence.py +2 -2
- package/scripts/mcp_registry_submit.sh +187 -0
- package/scripts/mcp_server/tools.py +1 -1
- package/scripts/measure_frugality_savings.py +10 -10
- package/scripts/measure_patterns.py +1 -1
- package/scripts/measure_projection_bytes.py +5 -5
- package/scripts/measure_rule_budget.py +3 -3
- package/scripts/measure_skill_reduction.py +1 -1
- package/scripts/memory_lookup.py +1 -1
- package/scripts/memory_status.py +2 -2
- package/scripts/migrate_command_suggestions.py +3 -3
- package/scripts/mine_session.py +1 -1
- package/scripts/move_artefact.py +3 -3
- package/scripts/new_skill.py +2 -2
- package/scripts/pack_mcp_content.py +9 -9
- package/scripts/plan_physical_move.py +6 -6
- package/scripts/print_required_checks.py +196 -0
- package/scripts/probe_skill_registration.py +413 -0
- package/scripts/propose_modules_config.py +145 -0
- package/scripts/prototype_lint_contradictions.py +1 -1
- package/scripts/recruit_preflight.sh +152 -0
- package/scripts/refine_ticket_detect.py +3 -3
- package/scripts/release.py +20 -0
- package/scripts/render_benchmark_md.py +308 -0
- package/scripts/roadmap_progress_hook.py +1 -1
- package/scripts/run_skill_evals.py +2 -2
- package/scripts/runtime_registry.py +4 -4
- package/scripts/schemas/command.schema.json +4 -4
- package/scripts/schemas/rule.schema.json +5 -5
- package/scripts/schemas/skill.schema.json +3 -3
- package/scripts/schemas/user-type.schema.json +1 -1
- package/scripts/score_skill_selection.py +1 -1
- package/scripts/skill_collision_clusters.py +2 -2
- package/scripts/skill_linter.py +81 -81
- package/scripts/skill_overlap.py +5 -5
- package/scripts/skill_tools/audit_persona_coverage.py +2 -2
- package/scripts/skill_tools/audit_user_type_coverage.py +2 -2
- package/scripts/skill_tools/run_block_d_eval.py +1 -1
- package/scripts/skill_tools/score_skill_relevance.py +1 -1
- package/scripts/skill_tools/suggest_skill_for_task.py +1 -1
- package/scripts/skill_trigger_eval.py +3 -3
- package/scripts/smoke/kernel.sh +7 -1
- package/scripts/smoke/router.sh +5 -5
- package/scripts/smoke/skills.sh +1 -1
- package/scripts/smoke_quickstart.py +1 -1
- package/scripts/snapshot_agent_outputs.py +3 -3
- package/scripts/spotcheck_thin_root.py +1 -1
- package/scripts/{caveman_stats.py → telegraph_stats.py} +18 -18
- package/scripts/update_counts.py +1 -1
- package/scripts/validate_decision_engine.py +1 -1
- package/scripts/validate_frontmatter.py +1 -1
- package/scripts/validate_safe_paths.py +3 -3
- package/scripts/{validate_caveman_carveouts.py → validate_telegraph_carveouts.py} +7 -7
- package/scripts/verify_roadmap_closure.py +6 -6
- package/templates/consumer-settings/ONBOARDING.md +41 -0
- package/.agent-src/commands/install-via-agent.md +0 -129
- package/.agent-src/skills/compress-memory/SKILL.md +0 -131
- package/dist/ui/assets/index-D-DY1ywI.js +0 -35
- package/dist/ui/assets/index-D-DY1ywI.js.map +0 -1
- package/dist/ui/assets/index-Dqfhmg-d.css +0 -1
- package/docs/adrs/caveman/README.md +0 -9
- package/docs/contracts/caveman-telemetry.md +0 -83
- package/scripts/compress.sh +0 -18
package/CHANGELOG.md
CHANGED
|
@@ -16,6 +16,61 @@ Entry-shape contract: [`docs/contracts/CHANGELOG-conventions.md`](docs/contracts
|
|
|
16
16
|
|
|
17
17
|
## [Unreleased]
|
|
18
18
|
|
|
19
|
+
### Breaking — v4.0.0 unified setup (`road-to-unified-setup`)
|
|
20
|
+
|
|
21
|
+
`v4.0.0` is a **hard-cut** release. The legacy Python installer at
|
|
22
|
+
`scripts/install.py` and the standalone TypeScript installer workspace
|
|
23
|
+
at `packages/core/installer/{src,tests}` are no longer the canonical
|
|
24
|
+
install path; the wizard now boots a single Fastify process at
|
|
25
|
+
`agent-config install` / `agent-config setup` and drives the whole
|
|
26
|
+
plan + apply through the TypeScript engine under `src/install/`.
|
|
27
|
+
|
|
28
|
+
**Migrating from v3.x**
|
|
29
|
+
|
|
30
|
+
1. The first `agent-config install` run detects an existing v3 tree at
|
|
31
|
+
`~/.event4u/agent-config/` and renders a **backup screen** before
|
|
32
|
+
any write. Pick **"Backup v3 and proceed"** — the wizard copies the
|
|
33
|
+
v3 layout to `~/.event4u/agent-config.v3.bak/` atomically and runs
|
|
34
|
+
the v4 install against a clean slate.
|
|
35
|
+
2. No auto-migration runs. Rolling back is a single rename:
|
|
36
|
+
`mv ~/.event4u/agent-config.v3.bak ~/.event4u/agent-config`.
|
|
37
|
+
3. Re-running `npx @event4u/agent-config install` against an active v3
|
|
38
|
+
layout (without backup) is refused — silent overwrite is gone.
|
|
39
|
+
|
|
40
|
+
**Removed / retired**
|
|
41
|
+
|
|
42
|
+
- `packages/core/installer/{src,tests,package.json,tsconfig.json,
|
|
43
|
+
vitest.config.ts}` (the standalone `@event4u/installer` workspace)
|
|
44
|
+
and its workspaces declaration in the root `package.json`.
|
|
45
|
+
- `/install-via-agent` command — its JSON agent-mode protocol shipped
|
|
46
|
+
with the removed installer.
|
|
47
|
+
- `task installer-typecheck` / `task installer-test` gates in
|
|
48
|
+
`taskfiles/ci-fast.yml`.
|
|
49
|
+
|
|
50
|
+
**Kept for one release**
|
|
51
|
+
|
|
52
|
+
- `scripts/install.py` remains so the `curl | bash setup.sh` CURL
|
|
53
|
+
fallback + `smoke-public-install.yml` CI matrix keep working. It is
|
|
54
|
+
**not** invoked from the modern npx flow. Full removal is scheduled
|
|
55
|
+
for v5.
|
|
56
|
+
|
|
57
|
+
**New features (Phase B / C / E)**
|
|
58
|
+
|
|
59
|
+
- Hard-stop **continue-screen** after Step 3 (modules) when entering
|
|
60
|
+
via `agent-config install`; `setup` lands directly at Step 4
|
|
61
|
+
(identity) via `?mode=setup`. (B5)
|
|
62
|
+
- `WIZARD_READY <url>` line on stdout once Fastify is bound; the new
|
|
63
|
+
`scripts/bootstrap.sh` watches for it so a Node bootstrap does not
|
|
64
|
+
poll the port. (B4 + C1)
|
|
65
|
+
- **Recovery-pre-step** — `GET /api/v1/install/recovery` surfaces an
|
|
66
|
+
abort marker (Resume / Rollback / Ignore) when the previous run
|
|
67
|
+
closed mid-apply. (B4 + Council Finding #24)
|
|
68
|
+
- **v3 backup screen** — `GET /api/v1/install/legacy-v3` +
|
|
69
|
+
`POST /api/v1/install/backup-v3` drive the migration. (E2 +
|
|
70
|
+
Council Finding #21)
|
|
71
|
+
- **Batch-conflict resolution** at ≥ 5 conflicts (B3 + Council
|
|
72
|
+
Finding #19).
|
|
73
|
+
|
|
19
74
|
**TypeScript CLI shell + local server foundation (`typescript-cli-and-local-gui-foundation`)** —
|
|
20
75
|
Phase-5 cutover of the `agent-config` binary from a 955-line Bash
|
|
21
76
|
dispatcher to a compiled TypeScript entry point. The shell handles
|
|
@@ -198,7 +253,7 @@ member, low-impact dispatch) under one roadmap. New surfaces:
|
|
|
198
253
|
fail → banner `airgapped environment detected — defaulting to
|
|
199
254
|
mode: api` and `defaults.member_mode: api` recommendation.
|
|
200
255
|
- **Fast-path marker visibility Iron-Law rule**
|
|
201
|
-
(`.agent-src.
|
|
256
|
+
(`.agent-src.uncondensed/rules/fast-path-marker-visibility.md`,
|
|
202
257
|
kernel-tier, always-active) — host agents MUST surface
|
|
203
258
|
`Resolved via low-impact council fast-path: …` markers verbatim;
|
|
204
259
|
swallowing them is a rule violation.
|
|
@@ -738,6 +793,129 @@ our recommendation order, not its support status.
|
|
|
738
793
|
> that forces a new era split (`# Era: 3.3.x`, etc.) — see
|
|
739
794
|
> [`docs/contracts/CHANGELOG-conventions.md § Era splits`](docs/contracts/CHANGELOG-conventions.md).
|
|
740
795
|
|
|
796
|
+
## [4.1.0](https://github.com/event4u-app/agent-config/compare/3.3.0...4.1.0) (2026-05-27)
|
|
797
|
+
|
|
798
|
+
### Features
|
|
799
|
+
|
|
800
|
+
* **roadmap:** restore skip_pre_run_gate (default true) to suppress the process-* confirmation ([746b472](https://github.com/event4u-app/agent-config/commit/746b472cc7ebb626114042ba18c91aa93ff36383))
|
|
801
|
+
* **adoption-signal:** signal-floor contract + snapshot collector + report rollup ([0a8ad93](https://github.com/event4u-app/agent-config/commit/0a8ad9361f15e25d8ff981d25b666d2b03cbd3a2))
|
|
802
|
+
* **mcp-registry:** submission helper + tracking sheet + adoption dashboard ([817d1a5](https://github.com/event4u-app/agent-config/commit/817d1a521e826766646da862900ff54be9f0d0e4))
|
|
803
|
+
* **recruit-sessions:** runbook + preflight script + tests ([9c6f50b](https://github.com/event4u-app/agent-config/commit/9c6f50b9a9c55a4c69e7b7ace66bde970ccc6238))
|
|
804
|
+
* **ci:** ci-green-floor contract + ci_status.py phantom filter ([d5eb355](https://github.com/event4u-app/agent-config/commit/d5eb35593685b82cd554829c75fe6cdc375cf378))
|
|
805
|
+
* **bench-ab:** phase 5 — report renderer + task entries + linter + contract ([c47960f](https://github.com/event4u-app/agent-config/commit/c47960feab0cd8a69f6c5e494eefd2a5346b71b3))
|
|
806
|
+
* **bench-ab:** phase 4 — track B task corpus + runner + scoring ([9f389da](https://github.com/event4u-app/agent-config/commit/9f389da0cc6ba74436e5842e54215eece23588d2))
|
|
807
|
+
* **bench-ab:** phase 3 — track A behavioural eval A/B ([56473ae](https://github.com/event4u-app/agent-config/commit/56473ae952b897623b1ff67b838a25cc16bef558))
|
|
808
|
+
* **bench-ab:** phase 2 — runner extension + baseline cache ([cb20841](https://github.com/event4u-app/agent-config/commit/cb20841a50de1d61afce2c1c7adb20600e0f8cb3))
|
|
809
|
+
* **bench-ab:** phase 1 — variant target + clone scaffolding ([296cb68](https://github.com/event4u-app/agent-config/commit/296cb683121e6ad6970527e20b18c09b3b837008))
|
|
810
|
+
* **roadmap:** add package-impact benchmark plan ([13ad7b0](https://github.com/event4u-app/agent-config/commit/13ad7b0eea415e42617fdacc3970c5a88fcde217))
|
|
811
|
+
* **roadmap:** add skip_pre_run_gate to suppress process-* confirmation ([87f12fa](https://github.com/event4u-app/agent-config/commit/87f12faf748674994e7d9d0f1ea48689103f5664))
|
|
812
|
+
* **ci:** lint_role_experiences.py + plain-language surface contract ([9845a1b](https://github.com/event4u-app/agent-config/commit/9845a1bbfd3f1ed66dec5b5c2f9bdf4b788296ff))
|
|
813
|
+
* **roles:** add sales/support/leadership + prompts for galabau/content-creator/consultant ([1846c1c](https://github.com/event4u-app/agent-config/commit/1846c1cfbbd37def8f87181292d329b8e901d4aa))
|
|
814
|
+
* **workspace:** ship WorkspacePage UI + a11y audit + Playwright suite ([bd469cc](https://github.com/event4u-app/agent-config/commit/bd469cc6d6d9371af96b6bbf2bc58405e0fcfc03))
|
|
815
|
+
* **workspace:** add /api/v1/workspace/* server routes ([d6ef98e](https://github.com/event4u-app/agent-config/commit/d6ef98e91d5df42bcb5c999efa3e980e6a0f9e9f))
|
|
816
|
+
* **rules:** forbid decorative emojis in git surfaces ([265c3f6](https://github.com/event4u-app/agent-config/commit/265c3f6c78244eb6a56e0c1ba0613f2c0d5f5c29))
|
|
817
|
+
* **ci:** skip heavy matrices on release PRs + add release-validation workflow ([26f26b9](https://github.com/event4u-app/agent-config/commit/26f26b97acd85b09fc26b2922e7885643403afe8))
|
|
818
|
+
* **rules:** gate unsolicited PR progress comments behind personal.pr_progress_comments ([4183131](https://github.com/event4u-app/agent-config/commit/41831315f12974ba1e326953c7abb98a0f14e7c8))
|
|
819
|
+
* **install:** bash bootstrap for the v4 unified setup wizard ([5519441](https://github.com/event4u-app/agent-config/commit/551944156c5c330a1b703e12ffba9bb3612ccdae))
|
|
820
|
+
* **install:** wizard conflict UI + recovery + continue + backup screens ([462cfbf](https://github.com/event4u-app/agent-config/commit/462cfbfa77583e50ea4aae167a4c2318ee7f0cb2))
|
|
821
|
+
* **install:** wizard state → plan (Phase B2) ([5e73633](https://github.com/event4u-app/agent-config/commit/5e736331710c13d4af8f6ec0283e0b32fe6693f1))
|
|
822
|
+
* **install:** unified setup wizard dispatch + install API with SSE progress ([4f932e1](https://github.com/event4u-app/agent-config/commit/4f932e1707645facbf1967cca086a182f6416b19))
|
|
823
|
+
* **install:** port AI-tool bridge generators (A6) ([62234bf](https://github.com/event4u-app/agent-config/commit/62234bf89ca2469bd1e854ea3dba3ddc0bb3a7b0))
|
|
824
|
+
* **install:** conflict resolution strategies (A5) ([b0f39f8](https://github.com/event4u-app/agent-config/commit/b0f39f827051cd05a838c6a07942678080574d01))
|
|
825
|
+
* **install:** atomic write + transaction log + apply pipeline (A4) ([885fc99](https://github.com/event4u-app/agent-config/commit/885fc9949655bec37d73659e954eb76bee3664b4))
|
|
826
|
+
* **install:** plan generator with conflict diffing (A3) ([81f3298](https://github.com/event4u-app/agent-config/commit/81f3298c04b8ccd6de5d277bafdf0bc1d7b88110))
|
|
827
|
+
* **install:** port project + AI-tool detection (A2) ([0f5c977](https://github.com/event4u-app/agent-config/commit/0f5c97720e188d6e4410f84638979d18289f4aa5))
|
|
828
|
+
* **install:** scaffold TS install-engine workspace (A1) ([3a2e41c](https://github.com/event4u-app/agent-config/commit/3a2e41c29f6516db35a75d26167ac460e1aad7e1))
|
|
829
|
+
* **ui:** unify shell with 6-tab navigation (Setup, Tasks, Council, Memory, Explain, Workspace) ([5ad6f22](https://github.com/event4u-app/agent-config/commit/5ad6f22abfd4cf29b6f5d4c7e8cfddfd5b126ad7))
|
|
830
|
+
* **cli:** wire extended-steps flag through setup command ([4192d8d](https://github.com/event4u-app/agent-config/commit/4192d8d89fbb985559bda6549c526f796c1c9c81))
|
|
831
|
+
* **wizard:** expand to 10-step extended flow with ai-tools, packs, modules ([55f88da](https://github.com/event4u-app/agent-config/commit/55f88daf48fa66ff51f892c6ef439f8b1dc0b8be))
|
|
832
|
+
* **wizard:** scope-guard + probe + harness-expectations endpoints ([3ced286](https://github.com/event4u-app/agent-config/commit/3ced2864425f9f2eb0906ff5ecd163320d12a174))
|
|
833
|
+
* **install:** canonical-channel discipline + scope guard + skill probe ([bbd434c](https://github.com/event4u-app/agent-config/commit/bbd434c4655e96c0c44919ea01ba11b8dd6e4e80))
|
|
834
|
+
* **modules:** on-the-fly module detection skill + acknowledge flag ([10d0044](https://github.com/event4u-app/agent-config/commit/10d00441f8a2fe23b1eb98fa0f87cd3bad859b61))
|
|
835
|
+
* **wizard:** add modules step to onboarding GUI ([92cc851](https://github.com/event4u-app/agent-config/commit/92cc851f4e57e83e64906202925cfc74f24293a7))
|
|
836
|
+
* **skills:** per-module agents/ folder discovery (Phase D) ([c174f73](https://github.com/event4u-app/agent-config/commit/c174f73978f08929cb84f734416c6d4f35d903c7))
|
|
837
|
+
* **skills:** generalize module-management + neutrality linter (Phase C) ([c653f39](https://github.com/event4u-app/agent-config/commit/c653f396624835732aa083df7d76ca16876e92d7))
|
|
838
|
+
* **install:** detect modules during install + /agents init (Phase B) ([c0e9b6a](https://github.com/event4u-app/agent-config/commit/c0e9b6aa5da93a752271b45383d335930024e82f))
|
|
839
|
+
* **modules:** add modules config block + loader (Phase A) ([2bd0bd2](https://github.com/event4u-app/agent-config/commit/2bd0bd20acacc06b6c342ced4e08017145e715a8))
|
|
840
|
+
|
|
841
|
+
### Bug Fixes
|
|
842
|
+
|
|
843
|
+
* **ci:** allow agents/.agent-tools.yml at agents/ root ([eadb5fa](https://github.com/event4u-app/agent-config/commit/eadb5fa290c3edbae8763ea1a2fa605fa549f35b))
|
|
844
|
+
* **ci:** trim AGENTS.md back under Thin-Root 3000-char hard cap ([1a2530b](https://github.com/event4u-app/agent-config/commit/1a2530b9670fb9088ed1a42d91c007c54975f142))
|
|
845
|
+
* **ci:** minimal retirement stub at packages/core/installer/ for the legacy Node-Tests job ([ae37148](https://github.com/event4u-app/agent-config/commit/ae371487c1c8c44ba0aa837ea42ca3bbd9b5cd3b))
|
|
846
|
+
* **skill-lint:** mirror agent-handoff trigger_context fix into compressed copy ([b17c4ef](https://github.com/event4u-app/agent-config/commit/b17c4ef8cfde53ddeb7ba764622020203a61b10b))
|
|
847
|
+
* **projection:** drop stale .claude/skills/install-via-agent/SKILL.md symlink ([21a6588](https://github.com/event4u-app/agent-config/commit/21a6588b9d9bf71cc322bffabf299585b3493fab))
|
|
848
|
+
* **ci:** bump always-rule top-3 concentration ceiling 10_900 → 11_300 ([8a7f301](https://github.com/event4u-app/agent-config/commit/8a7f301935d3bd28306bbdd098071b522eaf6f1b))
|
|
849
|
+
* **portability:** rephrase `task sync` → "sync pipeline" in cheap-question-mechanics ([5341087](https://github.com/event4u-app/agent-config/commit/534108756e13a8ddec4bb27d6a3e9ebd7a677aec))
|
|
850
|
+
* **ci:** clear v4 install-cutover blockers on PR #244 ([a031da4](https://github.com/event4u-app/agent-config/commit/a031da428c1427ea8080d56cc11c2e3db7efa356))
|
|
851
|
+
* **authority:** block execution offers after roadmap/vision artifact save ([d30d441](https://github.com/event4u-app/agent-config/commit/d30d441e27c0820df82102e7afa4a12e4cb45cac))
|
|
852
|
+
* **installer:** accept monorepo packs/<pack>/.agent-src.uncompressed/ prefix ([ac0b716](https://github.com/event4u-app/agent-config/commit/ac0b71651512b39c1f207204b1e3b02d33440031))
|
|
853
|
+
* **ci:** AGENTS.md size cap + scope_guard bash 5 set -e compatibility ([6018308](https://github.com/event4u-app/agent-config/commit/6018308ec622e29eaab42c35d43b462569a192db))
|
|
854
|
+
* **tests:** mirror agent_settings.py into work_engine template copy ([a755bb7](https://github.com/event4u-app/agent-config/commit/a755bb7cc2a0cc8b3f4dcbf2c24ba37ef8738472))
|
|
855
|
+
* **adr:** allow council refs in ADR decision-trace blocks ([f069596](https://github.com/event4u-app/agent-config/commit/f069596537c8ebd4ad6f2d828357d29e3a835739))
|
|
856
|
+
* **contracts:** align stability frontmatter for v0/design contracts ([f8020e9](https://github.com/event4u-app/agent-config/commit/f8020e94acee9639410a60038357c9db21b9fd2d))
|
|
857
|
+
* **tests:** mirror agent_settings.py into work_engine template copy ([029e9c4](https://github.com/event4u-app/agent-config/commit/029e9c4d967974aa7acf25b3331f9bf4e80dcc4d))
|
|
858
|
+
* **lint-agents-md:** trim consumer-template Thin-Root bullet ([dc4e8e6](https://github.com/event4u-app/agent-config/commit/dc4e8e6253ba081799e9f4c84c151bb442af75b3))
|
|
859
|
+
* **skill-lint:** trim module-management description + add analysis gate ([046ef48](https://github.com/event4u-app/agent-config/commit/046ef48ed7f318875fc6cf84157fe75c432f9608))
|
|
860
|
+
* **ci:** skip agents/tmp + allowlist module-aware Laravel-shape examples ([c351758](https://github.com/event4u-app/agent-config/commit/c351758daedc76b2234b7fab8643403b11173e64))
|
|
861
|
+
* **check-refs:** mark forward-ref to recruit-sessions/01-galabau-owner with ref-ignore ([dea821a](https://github.com/event4u-app/agent-config/commit/dea821af02dbd335884f95f89b868c55e6338cce))
|
|
862
|
+
|
|
863
|
+
### Performance
|
|
864
|
+
|
|
865
|
+
* **ci:** extract windows-lockfile + python-version sweep to path-filtered workflows ([e2d17f0](https://github.com/event4u-app/agent-config/commit/e2d17f071149884505d10e246421d13b67efed58))
|
|
866
|
+
|
|
867
|
+
### Documentation
|
|
868
|
+
|
|
869
|
+
* **posture:** record 2026-05 feedback citation against the cancellation wall ([f96b9c7](https://github.com/event4u-app/agent-config/commit/f96b9c7973c8be8d33252ad0330c8bd3126b4341))
|
|
870
|
+
* **ci:** wire `task ci:required-checks` + cross-links + archive roadmap ([069833c](https://github.com/event4u-app/agent-config/commit/069833c00cf13e3af34bd0328daecce61ef0ab11))
|
|
871
|
+
* **ci:** release-PR gating contract + shape detector + tests ([380e059](https://github.com/event4u-app/agent-config/commit/380e0591dcb661cb3da2e84089bcc1b6fb5cf397))
|
|
872
|
+
* **internal:** document new umbrella occupants in AGENTS.md and internal/README.md ([0b1a384](https://github.com/event4u-app/agent-config/commit/0b1a384db1545576208c50accebba92977ded335))
|
|
873
|
+
* **roadmap:** mark Phase B3-E3 done + archive road-to-unified-setup ([64162ab](https://github.com/event4u-app/agent-config/commit/64162abda143286d058b432018f0058fc71cca98))
|
|
874
|
+
* **roadmap:** mark Phase B0+B1 done on road-to-unified-setup ([098b809](https://github.com/event4u-app/agent-config/commit/098b8096d09449e2b358333691cc50f20ded5a58))
|
|
875
|
+
* **roadmap:** mark Phase A (A1-A6) done on road-to-unified-setup ([49a983b](https://github.com/event4u-app/agent-config/commit/49a983bcfc0a2974f41e53dbabed209730eac682))
|
|
876
|
+
* **roadmap:** add road-to-unified-setup v4.0.0 plan ([9601a81](https://github.com/event4u-app/agent-config/commit/9601a81fa88c248e9e7a4941ab25a462853953f1))
|
|
877
|
+
* distribution-channels + install-scopes + harness-expectations ([1351f51](https://github.com/event4u-app/agent-config/commit/1351f5102aabec85e09d7bc1433aeb265ac706f4))
|
|
878
|
+
* **roadmap:** close Phase E - Step 4 Won't do, archive roadmap ([842ef8e](https://github.com/event4u-app/agent-config/commit/842ef8eec2599a1e38b633a88db99afccaaf0f8b))
|
|
879
|
+
* **roadmap:** close Phase E for road-to-configurable-modules ([6cd2b56](https://github.com/event4u-app/agent-config/commit/6cd2b56e302b81ec601544bd90a5f51295d98c43))
|
|
880
|
+
* **roadmap:** mark configurable-modules Phases A-D complete + regen dashboard ([c4f1682](https://github.com/event4u-app/agent-config/commit/c4f16829f13d4bb4c727be4cd1f77bf90407e015))
|
|
881
|
+
* **roadmap:** land 5 new roadmaps + regen progress dashboard ([94c5192](https://github.com/event4u-app/agent-config/commit/94c5192090aa54df2958120224d33869b707bceb))
|
|
882
|
+
|
|
883
|
+
### Refactoring
|
|
884
|
+
|
|
885
|
+
* **naming:** rename compress→condense and caveman→telegraph across the suite ([6a72697](https://github.com/event4u-app/agent-config/commit/6a7269713c11dd10ae2b975d921207de2e0e08de))
|
|
886
|
+
* relocate .compression-hashes.json + .agent-tools.yml and rewrite path consumers ([6e545c8](https://github.com/event4u-app/agent-config/commit/6e545c8563aff3e0dc9c3c9b80148d4bc83c4337))
|
|
887
|
+
* **internal:** move docker/ + schemas/ to internal/ umbrella ([5cf589b](https://github.com/event4u-app/agent-config/commit/5cf589bbefdaedf29e01a8b906f59176d690ed0e))
|
|
888
|
+
|
|
889
|
+
### Tests
|
|
890
|
+
|
|
891
|
+
* regression coverage for distribution-channels track ([5ddc493](https://github.com/event4u-app/agent-config/commit/5ddc493fac8b05ec297f4b0f1714fb294f402ef7))
|
|
892
|
+
|
|
893
|
+
### Chores
|
|
894
|
+
|
|
895
|
+
* **roadmap:** wire ci:status + adoption:* tasks; close out adoption-proof-and-ci-green ([7421b6d](https://github.com/event4u-app/agent-config/commit/7421b6d52fa10e4e327d142717e0ee5f31f86747))
|
|
896
|
+
* add new hooks ([75708a5](https://github.com/event4u-app/agent-config/commit/75708a5bbde1380cb1ec54f6bc8aca086073f7a6))
|
|
897
|
+
* **roadmap:** close out frictionless-employee-workspace + regen dashboard ([5f1d376](https://github.com/event4u-app/agent-config/commit/5f1d376e741704a7602fefd283b469326ff749f0))
|
|
898
|
+
* **roadmaps:** archive road-to-deep-root-restructure (15/15 closed) ([1088332](https://github.com/event4u-app/agent-config/commit/10883323745485cab9ed7aaa3af12789a169549f))
|
|
899
|
+
* regenerate packages/core/{README.md,pack.yaml} after the new rule ([1847ae0](https://github.com/event4u-app/agent-config/commit/1847ae0e81cf764ec8dbe7e4dab49bac4d5f8433))
|
|
900
|
+
* update gitignor ([cc9a247](https://github.com/event4u-app/agent-config/commit/cc9a247beef83644de525d4f5574bc544b78cbaa))
|
|
901
|
+
* **docs:** drop command count from 136 → 135 after install-via-agent removal ([fecba73](https://github.com/event4u-app/agent-config/commit/fecba73b0f5b9c0c4a723a860cad0b0aff0f4a1f))
|
|
902
|
+
* **release:** bump to v4.0.0 + CHANGELOG hard-cut entry ([fa538ae](https://github.com/event4u-app/agent-config/commit/fa538ae6a347398925c06b89ebaa1a1809fd7a39))
|
|
903
|
+
* **install:** remove legacy TS installer workspace + reference cleanup ([3aa1e93](https://github.com/event4u-app/agent-config/commit/3aa1e93f58f98d6d0feeb1e066674a21eeaf2f40))
|
|
904
|
+
* **commands:** harden agent-handoff trigger detection and fenced-output contract ([1be7c7c](https://github.com/event4u-app/agent-config/commit/1be7c7ca813036129449e5020ab9dd78f02d4910))
|
|
905
|
+
* **gitignore:** close nested node_modules hole, drop stale tracked entries ([0ad9963](https://github.com/event4u-app/agent-config/commit/0ad9963f705811a2cbbecc2ac591a1f4d2b82d9d))
|
|
906
|
+
* **rules:** harden commit-chunking and cheap-question floors ([d824408](https://github.com/event4u-app/agent-config/commit/d824408c021095455eacb5e6d7f8169eafb76808))
|
|
907
|
+
* **workspaces:** scope npm workspaces to installer only ([c227f53](https://github.com/event4u-app/agent-config/commit/c227f5350c533a5094f3f5954c4aec67fdf42581))
|
|
908
|
+
* **roadmap:** audits + recruit findings placeholder for distribution-channels ([e739618](https://github.com/event4u-app/agent-config/commit/e739618f239f2fa58b26e256c0873e401b0f5f53))
|
|
909
|
+
* **generated:** regenerate sync outputs + counts for module-detect-on-the-fly ([ea624f3](https://github.com/event4u-app/agent-config/commit/ea624f348a90c88d214ccf7f9bdfdbd362dfa5ee))
|
|
910
|
+
* **generated:** regenerate ownership matrix, catalog, agent index ([796f674](https://github.com/event4u-app/agent-config/commit/796f674a2d29ee4f26438a53fd1e967966111848))
|
|
911
|
+
* **template:** bump agent_config_version to 3.3.0 ([76dcbc8](https://github.com/event4u-app/agent-config/commit/76dcbc8549b771bc930fbd15f9e5e819bee0f736))
|
|
912
|
+
|
|
913
|
+
### Other
|
|
914
|
+
|
|
915
|
+
* Revert "feat(roadmap): add skip_pre_run_gate to suppress process-* confirmation" ([e918d51](https://github.com/event4u-app/agent-config/commit/e918d516140cc0d6d8f432f8207626c81334ad86))
|
|
916
|
+
|
|
917
|
+
Tests: 5043 (+105 since 3.3.0)
|
|
918
|
+
|
|
741
919
|
## [3.3.0](https://github.com/event4u-app/agent-config/compare/3.2.0...3.3.0) (2026-05-25)
|
|
742
920
|
|
|
743
921
|
### Features
|
|
@@ -746,7 +924,7 @@ our recommendation order, not its support status.
|
|
|
746
924
|
|
|
747
925
|
### Bug Fixes
|
|
748
926
|
|
|
749
|
-
* **ci:** repoint bench/ -> internal/bench/ in projected agent-status +
|
|
927
|
+
* **ci:** repoint bench/ -> internal/bench/ in projected agent-status + condense-memory ([682040b](https://github.com/event4u-app/agent-config/commit/682040b230248bd054767ab10bd1e90ed3a1d0b7))
|
|
750
928
|
|
|
751
929
|
### Documentation
|
|
752
930
|
|
|
@@ -798,7 +976,7 @@ Tests: 4938 (+9 since 3.2.0)
|
|
|
798
976
|
* **counts:** sync command count to 136 (analytics cluster added) ([1d56496](https://github.com/event4u-app/agent-config/commit/1d564962bd57aedc6d4ff2ae6b757e45e8a63e2c))
|
|
799
977
|
* **release:** bump agent_config_version in templates to match package.json 3.1.1 ([4864332](https://github.com/event4u-app/agent-config/commit/4864332804fe9979a4f94cb053cdd13c7473ac40))
|
|
800
978
|
* **sync:** regenerate index + catalog for analytics commands ([77cb4fa](https://github.com/event4u-app/agent-config/commit/77cb4fa41d8b2773e7f5ece27f385d7b42862f5f))
|
|
801
|
-
* **sync:** regenerate
|
|
979
|
+
* **sync:** regenerate condensed analytics commands + Claude skill stubs ([41728c4](https://github.com/event4u-app/agent-config/commit/41728c4400c8cabaa8966d2708fbb4f3cef64adb))
|
|
802
980
|
* **knowledge:** regenerate projections + manifests for /knowledge cluster ([f4c5a26](https://github.com/event4u-app/agent-config/commit/f4c5a26bffef0a25918bdde42131354c9dd5295d))
|
|
803
981
|
* **discovery:** add agent-skills and cinematic-ai-video to topics ([5c01d5e](https://github.com/event4u-app/agent-config/commit/5c01d5e152bda559aefd48fd8220f2a3cbd90249))
|
|
804
982
|
|
package/CONTRIBUTING.md
CHANGED
|
@@ -49,14 +49,14 @@ task ci # full pipeline — must be green before PR
|
|
|
49
49
|
```
|
|
50
50
|
|
|
51
51
|
All checks must pass before a PR is merged:
|
|
52
|
-
`sync-check`, `consistency`, `check-
|
|
52
|
+
`sync-check`, `consistency`, `check-condensation`, `check-refs`,
|
|
53
53
|
`check-portability`, `lint-skills`, `test`, `lint-readme`.
|
|
54
54
|
|
|
55
55
|
## Source of truth
|
|
56
56
|
|
|
57
|
-
- **Edit** `.agent-src.
|
|
58
|
-
- **Do not edit** `.agent-src/` directly — it is the
|
|
59
|
-
in the package, generated from the
|
|
57
|
+
- **Edit** `.agent-src.uncondensed/` — the authoring layer with verbose content.
|
|
58
|
+
- **Do not edit** `.agent-src/` directly — it is the condensed output shipped
|
|
59
|
+
in the package, generated from the uncondensed layer by `task sync`.
|
|
60
60
|
- **Do not edit** `.augment/` directly either — it is a local projection of
|
|
61
61
|
`.agent-src/` for Augment Code (gitignored), rebuilt by `task sync`.
|
|
62
62
|
- **Do not edit** `.claude/`, `.cursor/`, `.clinerules/`, `.windsurfrules` —
|
|
@@ -65,7 +65,7 @@ All checks must pass before a PR is merged:
|
|
|
65
65
|
Helper commands:
|
|
66
66
|
|
|
67
67
|
```bash
|
|
68
|
-
task sync # .agent-src.
|
|
68
|
+
task sync # .agent-src.uncondensed/ → .agent-src/, then project → .augment/
|
|
69
69
|
task generate-tools # Regenerate .claude/, .cursor/, .clinerules/, .windsurfrules
|
|
70
70
|
task test # pytest tests/ + installer integration tests
|
|
71
71
|
task lint-skills # python3 scripts/skill_linter.py --all
|
|
@@ -84,13 +84,13 @@ task lint-skills # python3 scripts/skill_linter.py --all
|
|
|
84
84
|
|
|
85
85
|
## Adding or editing skills, rules, and commands
|
|
86
86
|
|
|
87
|
-
- Skills, rules, and commands live in `.agent-src.
|
|
87
|
+
- Skills, rules, and commands live in `.agent-src.uncondensed/`.
|
|
88
88
|
- Each skill must pass `task lint-skills` — frontmatter, structure, size
|
|
89
89
|
budgets, and self-containment are enforced by the linter.
|
|
90
90
|
- Size budgets are enforced by the `size-enforcement` rule and the linter.
|
|
91
91
|
See [`size-enforcement`](.agent-src/rules/size-enforcement.md)
|
|
92
92
|
for the current limits.
|
|
93
|
-
- After editing content under `.agent-src.
|
|
93
|
+
- After editing content under `.agent-src.uncondensed/`, run `task sync` so
|
|
94
94
|
`.agent-src/`, `.augment/`, and the tool-specific projections stay in sync.
|
|
95
95
|
- Skills must remain project-agnostic. Nothing in `.agent-src/` may reference a
|
|
96
96
|
specific consumer project, domain, or stack. The
|
|
@@ -115,22 +115,22 @@ intent — *"a skill that validates JWT tokens"*, *"a rule banning
|
|
|
115
115
|
silent fallbacks"* — and the agent:
|
|
116
116
|
|
|
117
117
|
- picks the right artefact type (skill vs. rule vs. command vs. guideline);
|
|
118
|
-
- places it in the correct directory under `.agent-src.
|
|
118
|
+
- places it in the correct directory under `.agent-src.uncondensed/`;
|
|
119
119
|
- writes frontmatter, trigger phrase (≤ 200 chars, multi-trigger coverage),
|
|
120
120
|
required sections, and a size budget that fits the linter;
|
|
121
|
-
- runs `task sync` so the
|
|
121
|
+
- runs `task sync` so the condensed and projected copies stay aligned;
|
|
122
122
|
- runs `task lint-skills` and `task ci` and proposes fixes for any
|
|
123
123
|
failures.
|
|
124
124
|
|
|
125
125
|
You do not need to memorise the directory layout, the kernel-rule budget,
|
|
126
|
-
the size enforcement table, or the
|
|
126
|
+
the size enforcement table, or the condensation-hash registry. You do
|
|
127
127
|
need to know *what* you want, *why* it generalises beyond your project,
|
|
128
128
|
and *when* the agent's draft is wrong.
|
|
129
129
|
|
|
130
130
|
### What CI catches and what it does not
|
|
131
131
|
|
|
132
132
|
CI is structural, not semantic. `task ci` enforces frontmatter shape,
|
|
133
|
-
description length, size budgets,
|
|
133
|
+
description length, size budgets, condensation-hash drift, broken
|
|
134
134
|
cross-references, missing language anchors, kernel-rule prominence, and
|
|
135
135
|
roadmap-dashboard sync. It will reject a malformed skill before review.
|
|
136
136
|
|
|
@@ -201,6 +201,25 @@ The setting flip is the easy part. Before enabling it, confirm:
|
|
|
201
201
|
`tests/test_install_orchestrator.sh` (orchestrator + wrappers), and
|
|
202
202
|
Python unit tests under `tests/`.
|
|
203
203
|
|
|
204
|
+
### npm workspaces — scope discipline
|
|
205
|
+
|
|
206
|
+
The root `package.json` declares no workspaces as of v4.0.0
|
|
207
|
+
(road-to-unified-setup § D1). The `@event4u/installer` workspace was
|
|
208
|
+
removed when the TypeScript installer at `packages/core/installer/{src,
|
|
209
|
+
tests}` was retired in favour of the unified setup engine at
|
|
210
|
+
`src/install/`. Subsequent maintainers should avoid re-introducing
|
|
211
|
+
workspaces unless a published sub-package genuinely needs root-level
|
|
212
|
+
script orchestration — `packages/cloud/telemetry-worker` deliberately
|
|
213
|
+
stays out because it is deployed via `wrangler`, not built through
|
|
214
|
+
the root.
|
|
215
|
+
|
|
216
|
+
Do **not** add `npm test --workspaces`, `npm run build --workspaces`,
|
|
217
|
+
or monorepo-style fan-out scripts without architectural review.
|
|
218
|
+
|
|
219
|
+
If the only need is "run an npm script inside a sub-package", prefer
|
|
220
|
+
`npm run <script> --prefix packages/<pack>` — it works without any
|
|
221
|
+
root `workspaces` field and avoids hoisting side effects.
|
|
222
|
+
|
|
204
223
|
## Versioning policy
|
|
205
224
|
|
|
206
225
|
The package follows [Semantic Versioning](https://semver.org). Because the
|
|
@@ -209,7 +228,7 @@ the policy is interpreted as follows:
|
|
|
209
228
|
|
|
210
229
|
| Bump | Triggers |
|
|
211
230
|
|---|---|
|
|
212
|
-
| **Major** (X.0.0) | Installer layout changes (files created/removed), breaking changes to `.agent-settings.yml` keys, removal of rules or skills that downstream projects relied on, breaking changes to the
|
|
231
|
+
| **Major** (X.0.0) | Installer layout changes (files created/removed), breaking changes to `.agent-settings.yml` keys, removal of rules or skills that downstream projects relied on, breaking changes to the condensed content format. |
|
|
213
232
|
| **Minor** (x.X.0) | New skills, rules, commands, or guidelines. New tool support. New installer flags. New `.agent-settings.yml` keys with safe defaults. |
|
|
214
233
|
| **Patch** (x.x.X) | Wording fixes and improvements in existing skills, linter fixes, CI changes, documentation updates, internal refactors with no user-visible effect. |
|
|
215
234
|
|
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
[](https://github.com/event4u-app/agent-config/actions/workflows/smoke.yml) [](https://github.com/event4u-app/agent-config/actions/workflows/smoke-public-install.yml) [](https://www.npmjs.com/package/@event4u/agent-config)
|
|
6
6
|
|
|
7
|
-
[](.agent-src/skills/) [](.agent-src/rules/) [](.agent-src/commands/) [](docs/guidelines/) [](.agent-src/personas/) [](.agent-src/personas/advisors/)
|
|
8
8
|
|
|
9
9
|
> **The Universal AI Agent OS for Founders, Content Creators, Consultants, Sales, Finance, and Engineering teams. Bring your own AI provider.**
|
|
10
10
|
|
|
@@ -30,9 +30,9 @@ six entries, no role-detection guesswork.
|
|
|
30
30
|
**Not sure which one?** Run `npx @event4u/agent-config init` then
|
|
31
31
|
`agent-config setup` — the browser wizard asks a single 8-option role
|
|
32
32
|
question and maps to the closest profile. Source-of-truth:
|
|
33
|
-
[`packages/core/.agent-src.
|
|
33
|
+
[`packages/core/.agent-src.uncondensed/profiles/`](packages/core/.agent-src.uncondensed/profiles/) ·
|
|
34
34
|
schema: [`docs/contracts/profile-system.md`](docs/contracts/profile-system.md).
|
|
35
|
-
Beyond software: [`user-types/`](packages/core/.agent-src.
|
|
35
|
+
Beyond software: [`user-types/`](packages/core/.agent-src.uncondensed/user-types/)
|
|
36
36
|
(galabau · metalworking · truck — see [Beyond software](#beyond-software).
|
|
37
37
|
|
|
38
38
|
<p align="center">
|
|
@@ -52,6 +52,12 @@ shows the wired AIs; [`docs/featured-commands.md`](docs/featured-commands.md)
|
|
|
52
52
|
lists the end-to-end workflows (`/implement-ticket`, `/work`,
|
|
53
53
|
`/commit`, `/create-pr`). Deeper tour: [2-minute demo](#2-minute-demo--implement-ticket).
|
|
54
54
|
|
|
55
|
+
**Install scope.** Pick **one** scope per machine — project-local (default, recommended for application repos) or user-global (recommended for tooling repos / dotfiles). The installer refuses cross-scope drift via the `scope_guard` pre-flight. Contract: [`docs/contracts/install-scopes.md`](docs/contracts/install-scopes.md). Cleanup when needed: `bash scripts/cleanup_other_scope.sh --confirm`.
|
|
56
|
+
|
|
57
|
+
## Harness expectations
|
|
58
|
+
|
|
59
|
+
Three classes of behaviour look like package bugs but are host-harness behaviour the package cannot control — sibling-plugin namespaces (`codex:*`, `cc-gemini-plugin:*`), deferred tools surfaced via `ToolSearch`, and cross-scope skill drift (real bug, fixed in the distribution-channels track). Diagnostics + the package's response: [`docs/contracts/harness-expectations.md`](docs/contracts/harness-expectations.md). First step when a skill appears twice: `task probe:skills`.
|
|
60
|
+
|
|
55
61
|
## Prove it
|
|
56
62
|
|
|
57
63
|
Audit-disciplined by construction — every memory consult, decision
|
|
@@ -66,7 +72,7 @@ Working on the package itself? [Development](#development) covers the
|
|
|
66
72
|
`task ci` pipeline, [Requirements](#requirements) the toolchain,
|
|
67
73
|
[Maintainer telemetry](#maintainer-telemetry-opt-in-default-off) the
|
|
68
74
|
opt-in measurement loop. Source-of-truth tree is
|
|
69
|
-
`packages/core/.agent-src.
|
|
75
|
+
`packages/core/.agent-src.uncondensed/`; never hand-edit `.augment/` or `.agent-src/`.
|
|
70
76
|
|
|
71
77
|
---
|
|
72
78
|
|
|
@@ -106,7 +112,7 @@ It is **not** an agent runtime. The agent loop, the LLM dispatcher, and tool orc
|
|
|
106
112
|
| In scope | Out of scope |
|
|
107
113
|
|---|---|
|
|
108
114
|
| Skills, rules, commands, guidelines, personas | Agent loop / LLM dispatcher |
|
|
109
|
-
| Multi-tool projection +
|
|
115
|
+
| Multi-tool projection + condensation pipeline | Execution engine inside the package |
|
|
110
116
|
| Memory helpers (`memory-add`, `memory-promote`) | Cross-tool observability dashboard |
|
|
111
117
|
| Linters, CI, frontmatter validation against [JSON-Schema](scripts/schemas/) ([contract](agents/reference/docs/frontmatter-contract.md)) | Runtime GUI / web dashboard |
|
|
112
118
|
| Skill orchestration via citations + deterministic helpers | Opinionated skill-resolver algorithm |
|
|
@@ -231,6 +237,8 @@ task mcp:cloud:secret-put # opt in to bearer-auth (recommended for private de
|
|
|
231
237
|
|
|
232
238
|
The Hard Floor on organization-mode features (SSO, central policy, OAuth connectors, team-context) is preserved by design — they stay cancelled until a real first customer + funded security audit lifts them. The small-team recipe is the supported path in the meantime.
|
|
233
239
|
|
|
240
|
+
> *The 9.3/10 feedback round (2026-05-25) re-asked for OAuth knowledge connectors, IAM / org governance, and organization-shared memory. Each is a stable cancellation row in [`team-deployment-posture`](docs/deploy/team-deployment-posture.md) under the same three release gates — recruited team customer · funded audit · maintainer ADR.*
|
|
241
|
+
|
|
234
242
|
### Optional: persistent agent memory
|
|
235
243
|
|
|
236
244
|
[`@event4u/agent-memory`](https://www.npmjs.com/package/@event4u/agent-memory) — MCP-based backend for cross-session learnings. **Strictly optional**; without it, skills fall back to file-based memory under `agents/memory/`.
|
|
@@ -299,13 +307,13 @@ Stack-agnostic governance core (orchestration · role modes · command clusters
|
|
|
299
307
|
|
|
300
308
|
### Beyond software
|
|
301
309
|
|
|
302
|
-
The same orchestration core drives non-software trades via [`user-types/`](packages/core/.agent-src.
|
|
310
|
+
The same orchestration core drives non-software trades via [`user-types/`](packages/core/.agent-src.uncondensed/user-types/): [`galabau-field-crew`](packages/core/.agent-src.uncondensed/user-types/galabau-field-crew.md) · [`metalworking-shop`](packages/core/.agent-src.uncondensed/user-types/metalworking-shop.md) · [`truck-driver`](packages/core/.agent-src.uncondensed/user-types/truck-driver.md). Contribute your own — [5-minute scaffold](packages/core/.agent-src.uncondensed/user-types/_template/).
|
|
303
311
|
|
|
304
312
|
---
|
|
305
313
|
|
|
306
314
|
## Data governance & domain safety
|
|
307
315
|
|
|
308
|
-
Three domain-safety rules ([`domain-safety-pii`](packages/core/.agent-src.
|
|
316
|
+
Three domain-safety rules ([`domain-safety-pii`](packages/core/.agent-src.uncondensed/rules/domain-safety-pii.md), [`domain-safety-disclaimer`](packages/core/.agent-src.uncondensed/rules/domain-safety-disclaimer.md), [`domain-safety-retention`](packages/core/.agent-src.uncondensed/rules/domain-safety-retention.md)) act as per-domain output floors across ~12 areas — PII redaction (support / finance / recruiting / marketing), advice disclaimers (legal / financial / medical / consulting), retention guidance (finance / support), ops floors (logging / export). Full surface → rule → floor matrix: [`docs/safety.md`](docs/safety.md). Beta contracts: [`memory-visibility-v1`](docs/contracts/memory-visibility-v1.md) · [`decision-trace-v1`](docs/contracts/decision-trace-v1.md).
|
|
309
317
|
|
|
310
318
|
### Maintainer telemetry (opt-in, default-off)
|
|
311
319
|
|
|
@@ -335,17 +343,17 @@ When a prompt matches a command's purpose ("setze ticket ABC-123 um" → `/imple
|
|
|
335
343
|
| [**Installation**](docs/installation.md) | All install paths, Composer/npm, orchestrator details |
|
|
336
344
|
| [**Architecture**](docs/architecture.md) | System layers, content pipeline, tool support matrix |
|
|
337
345
|
| [**Customization**](docs/customization.md) | Overrides, AGENTS.md, agent settings, cost profiles |
|
|
338
|
-
| [**Quality & CI**](docs/quality.md) | Linting, CI pipeline,
|
|
346
|
+
| [**Quality & CI**](docs/quality.md) | Linting, CI pipeline, condensation system |
|
|
339
347
|
| [**Migration**](docs/MIGRATION.md) | Per-version upgrade steps |
|
|
340
348
|
| [**Showcase**](docs/showcase.md) | More examples & expected behavior |
|
|
341
349
|
|
|
342
|
-
Browse content: [all
|
|
350
|
+
Browse content: [all 135 commands](.agent-src/commands/) · [skills catalog](docs/skills-catalog.md) · [full catalog](docs/catalog.md) · [`llms.txt`](llms.txt).
|
|
343
351
|
|
|
344
352
|
---
|
|
345
353
|
|
|
346
354
|
## Development
|
|
347
355
|
|
|
348
|
-
Working on the package itself? Edit `packages/core/.agent-src.
|
|
356
|
+
Working on the package itself? Edit `packages/core/.agent-src.uncondensed/`, regenerate trees:
|
|
349
357
|
|
|
350
358
|
```bash
|
|
351
359
|
task sync # regenerate .agent-src/ and .augment/
|
|
@@ -79,6 +79,15 @@ personal:
|
|
|
79
79
|
# Personal preference — each developer decides for themselves.
|
|
80
80
|
pr_comment_bot_icon: false
|
|
81
81
|
|
|
82
|
+
# Allow the agent to post unsolicited progress / status comments on
|
|
83
|
+
# an open PR (e.g. "CI fix iteration #2", "blocked on workflow scope").
|
|
84
|
+
# true = agent may narrate work on the PR via `gh pr comment` etc.
|
|
85
|
+
# false = default; agent never auto-comments. User-invoked flows
|
|
86
|
+
# (/fix:pr-comments, /create-pr, /code-review, explicit
|
|
87
|
+
# "post a comment that …") are NOT gated by this setting.
|
|
88
|
+
# See rules/no-pr-progress-comments.md.
|
|
89
|
+
pr_progress_comments: false
|
|
90
|
+
|
|
82
91
|
# Autonomous execution — suppress trivial workflow questions (on, off, auto)
|
|
83
92
|
# on = act on the obvious next step; never ask "Step 2 or 3?", "should I commit?", etc.
|
|
84
93
|
# off = ask trivial workflow questions (legacy behavior)
|
|
@@ -118,7 +127,7 @@ github:
|
|
|
118
127
|
#
|
|
119
128
|
# Controls how rule files are written into .augment/rules/ during
|
|
120
129
|
# install (scripts/install.sh) and the package's own projection
|
|
121
|
-
# (scripts/
|
|
130
|
+
# (scripts/condense.py --project-augment).
|
|
122
131
|
#
|
|
123
132
|
# Augment Code historically does not load symlinked rule files, so the
|
|
124
133
|
# default is to write each rule as a real copy. Flip the toggle to true
|
|
@@ -158,7 +167,7 @@ chat_history:
|
|
|
158
167
|
|
|
159
168
|
# Overflow behavior
|
|
160
169
|
# rotate = drop oldest entries to stay under max_size_kb
|
|
161
|
-
#
|
|
170
|
+
# condense = mark for summarization on the next agent turn
|
|
162
171
|
on_overflow: __CHAT_HISTORY_ON_OVERFLOW__
|
|
163
172
|
|
|
164
173
|
# Per-entry-type text-length caps (chars). 0 = verbatim, no slice.
|
|
@@ -192,6 +201,17 @@ pipelines:
|
|
|
192
201
|
# in the same response — that cadence is governed by `roadmap-progress-sync`
|
|
193
202
|
# and is non-negotiable. This setting only governs *quality tool runs*.
|
|
194
203
|
roadmap:
|
|
204
|
+
# Skip the /roadmap:process-* pre-run confirmation gate (true, false).
|
|
205
|
+
# true = default. The command name names the scope; a discoverable
|
|
206
|
+
# single active roadmap (or a named one) starts the loop
|
|
207
|
+
# immediately, resolved config surfaced inline so a wrong
|
|
208
|
+
# pick can still be aborted mid-stream.
|
|
209
|
+
# false = legacy. Shows the pre-run summary with numbered options
|
|
210
|
+
# and waits. The gate is still shown regardless when the
|
|
211
|
+
# roadmap is ambiguous or a scope / cadence conflict has no
|
|
212
|
+
# sensible default. See rules/autonomous-execution.md.
|
|
213
|
+
skip_pre_run_gate: true
|
|
214
|
+
|
|
195
215
|
# When to run quality tools during /roadmap execute.
|
|
196
216
|
# end_of_roadmap = once, before archiving the completed roadmap (default — fastest, fewest tokens)
|
|
197
217
|
# per_phase = once after every completed phase
|
|
@@ -18,51 +18,51 @@
|
|
|
18
18
|
# /skill-management, /override:create, etc. They carry no runtime
|
|
19
19
|
# frontmatter on purpose: the consuming command fills it in. Quarantined
|
|
20
20
|
# from the discovery manifest so strict mode stays clean.
|
|
21
|
-
- path: .agent-src.
|
|
21
|
+
- path: .agent-src.uncondensed/templates/AGENTS.md
|
|
22
22
|
reason: scaffold template for new project AGENTS.md; placeholders filled by /agents init
|
|
23
|
-
- path: .agent-src.
|
|
23
|
+
- path: .agent-src.uncondensed/templates/agent-settings.md
|
|
24
24
|
reason: scaffold for project .agent-settings.yml
|
|
25
|
-
- path: .agent-src.
|
|
25
|
+
- path: .agent-src.uncondensed/templates/command.md
|
|
26
26
|
reason: scaffold for new slash-command authoring
|
|
27
|
-
- path: .agent-src.
|
|
27
|
+
- path: .agent-src.uncondensed/templates/contexts.md
|
|
28
28
|
reason: scaffold index for project contexts/
|
|
29
|
-
- path: .agent-src.
|
|
29
|
+
- path: .agent-src.uncondensed/templates/contexts/auth-model.md
|
|
30
30
|
reason: scaffold for project auth-model context
|
|
31
|
-
- path: .agent-src.
|
|
31
|
+
- path: .agent-src.uncondensed/templates/contexts/data-sensitivity.md
|
|
32
32
|
reason: scaffold for project data-sensitivity context
|
|
33
|
-
- path: .agent-src.
|
|
33
|
+
- path: .agent-src.uncondensed/templates/contexts/deployment-order.md
|
|
34
34
|
reason: scaffold for project deployment-order context
|
|
35
|
-
- path: .agent-src.
|
|
35
|
+
- path: .agent-src.uncondensed/templates/contexts/observability.md
|
|
36
36
|
reason: scaffold for project observability context
|
|
37
|
-
- path: .agent-src.
|
|
37
|
+
- path: .agent-src.uncondensed/templates/contexts/tenant-boundaries.md
|
|
38
38
|
reason: scaffold for project tenant-boundaries context
|
|
39
|
-
- path: .agent-src.
|
|
39
|
+
- path: .agent-src.uncondensed/templates/copilot-instructions.md
|
|
40
40
|
reason: scaffold for project copilot-instructions.md
|
|
41
|
-
- path: .agent-src.
|
|
41
|
+
- path: .agent-src.uncondensed/templates/features.md
|
|
42
42
|
reason: scaffold for project features.md catalogue
|
|
43
|
-
- path: .agent-src.
|
|
43
|
+
- path: .agent-src.uncondensed/templates/overrides/command.md
|
|
44
44
|
reason: scaffold for project override of a shared command
|
|
45
|
-
- path: .agent-src.
|
|
45
|
+
- path: .agent-src.uncondensed/templates/overrides/guideline.md
|
|
46
46
|
reason: scaffold for project override of a shared guideline
|
|
47
|
-
- path: .agent-src.
|
|
47
|
+
- path: .agent-src.uncondensed/templates/overrides/rule.md
|
|
48
48
|
reason: scaffold for project override of a shared rule
|
|
49
|
-
- path: .agent-src.
|
|
49
|
+
- path: .agent-src.uncondensed/templates/overrides/skill.md
|
|
50
50
|
reason: scaffold for project override of a shared skill
|
|
51
|
-
- path: .agent-src.
|
|
51
|
+
- path: .agent-src.uncondensed/templates/overrides/template.md
|
|
52
52
|
reason: scaffold-of-scaffold for new override types
|
|
53
|
-
- path: .agent-src.
|
|
53
|
+
- path: .agent-src.uncondensed/templates/persona.md
|
|
54
54
|
reason: scaffold for new persona authoring
|
|
55
|
-
- path: .agent-src.
|
|
55
|
+
- path: .agent-src.uncondensed/templates/roadmaps.md
|
|
56
56
|
reason: scaffold for new roadmap authoring
|
|
57
|
-
- path: .agent-src.
|
|
57
|
+
- path: .agent-src.uncondensed/templates/rule.md
|
|
58
58
|
reason: scaffold for new rule authoring
|
|
59
|
-
- path: .agent-src.
|
|
59
|
+
- path: .agent-src.uncondensed/templates/scripts/.pytest_cache/README.md
|
|
60
60
|
reason: pytest cache artefact, not an agent-config artefact
|
|
61
|
-
- path: .agent-src.
|
|
61
|
+
- path: .agent-src.uncondensed/templates/scripts/README.md
|
|
62
62
|
reason: scaffold README for project scripts/
|
|
63
|
-
- path: .agent-src.
|
|
63
|
+
- path: .agent-src.uncondensed/templates/skill-archive-note.md
|
|
64
64
|
reason: scaffold for archive-note generation
|
|
65
|
-
- path: .agent-src.
|
|
65
|
+
- path: .agent-src.uncondensed/templates/skill.md
|
|
66
66
|
reason: scaffold for new SKILL.md authoring
|
|
67
|
-
- path: .agent-src.
|
|
67
|
+
- path: .agent-src.uncondensed/README.md
|
|
68
68
|
reason: package-root orientation; carries no artefact frontmatter — follows package core
|
package/config/profiles/full.ini
CHANGED