@event4u/agent-config 9.7.0 → 9.9.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 +1 -1
- package/CHANGELOG.md +314 -190
- package/CONTRIBUTING.md +23 -7
- package/MIGRATION.md +20 -0
- package/README.md +57 -11
- package/dist/agent-src/commands/agents/audit.md +1 -1
- package/dist/agent-src/commands/agents/optimize.md +2 -2
- package/dist/agent-src/commands/agents/user.md +1 -1
- package/dist/agent-src/commands/agents.md +1 -1
- package/dist/agent-src/commands/check-current-md.md +3 -3
- package/dist/agent-src/commands/commit/in-chunks.md +8 -0
- package/dist/agent-src/commands/commit.md +17 -0
- package/dist/agent-src/commands/fix/portability.md +2 -2
- package/dist/agent-src/commands/fix/pr-comments-loop.md +136 -0
- package/dist/agent-src/commands/fix/refs.md +2 -2
- package/dist/agent-src/commands/fix/route.md +4 -3
- package/dist/agent-src/commands/fix.md +9 -6
- package/dist/agent-src/commands/ghostwriter.md +1 -1
- package/dist/agent-src/commands/image.md +1 -1
- package/dist/agent-src/commands/optimize/augmentignore.md +1 -1
- package/dist/agent-src/commands/optimize/skills.md +2 -2
- package/dist/agent-src/commands/post-as.md +1 -1
- package/dist/agent-src/commands/pr/create.md +4 -0
- package/dist/agent-src/commands/research.md +1 -1
- package/dist/agent-src/commands/roadmap/ai-council.md +1 -1
- package/dist/agent-src/commands/security-audit-config.md +1 -1
- package/dist/agent-src/commands/team/delegate.md +4 -0
- package/dist/agent-src/commands/video.md +1 -1
- package/dist/agent-src/contexts/authority/kernel-rule-edits.md +1 -1
- package/dist/agent-src/contexts/contracts/emergency-triage-block.md +2 -2
- package/dist/agent-src/contexts/execution/auto-dispatch-classification.md +48 -2
- package/dist/agent-src/contexts/execution/orchestration-telemetry.md +10 -0
- package/dist/agent-src/contexts/execution/subagent-modes-detail.md +109 -8
- package/dist/agent-src/contexts/execution/subagent-response-contract.md +20 -0
- package/dist/agent-src/contexts/execution/subagent-spawn-contract.md +53 -3
- package/dist/agent-src/contexts/override-system.md +75 -5
- package/dist/agent-src/rules/code-provenance.md +112 -0
- package/dist/agent-src/rules/context-hygiene.md +2 -0
- package/dist/agent-src/rules/doc-screenshot-hygiene.md +97 -0
- package/dist/agent-src/rules/domain-safety-pii.md +1 -0
- package/dist/agent-src/rules/external-code-graph-interop.md +13 -3
- package/dist/agent-src/rules/framework-neutrality-in-generic-skills.md +2 -0
- package/dist/agent-src/rules/git-history-discipline.md +2 -0
- package/dist/agent-src/rules/history-discipline.md +80 -0
- package/dist/agent-src/rules/language-and-tone.md +2 -0
- package/dist/agent-src/rules/lethal-trifecta-guard.md +3 -0
- package/dist/agent-src/rules/media-governance-routing.md +2 -0
- package/dist/agent-src/rules/minimal-safe-diff.md +2 -0
- package/dist/agent-src/rules/no-roadmap-references.md +4 -1
- package/dist/agent-src/rules/non-destructive-by-default.md +20 -0
- package/dist/agent-src/rules/onboarding-gate.md +2 -0
- package/dist/agent-src/rules/output-discipline.md +2 -0
- package/dist/agent-src/rules/persona-governance.md +2 -0
- package/dist/agent-src/rules/php-coding.md +1 -0
- package/dist/agent-src/rules/preservation-guard.md +3 -0
- package/dist/agent-src/rules/reviewer-awareness.md +1 -0
- package/dist/agent-src/rules/roadmap-ci-steps-policy.md +1 -0
- package/dist/agent-src/rules/roadmap-progress-sync.md +9 -0
- package/dist/agent-src/rules/scale-discipline.md +92 -0
- package/dist/agent-src/rules/secret-vcs-guard.md +106 -0
- package/dist/agent-src/rules/security-sensitive-stop.md +11 -1
- package/dist/agent-src/rules/session-canary.md +77 -0
- package/dist/agent-src/rules/skill-quality.md +2 -0
- package/dist/agent-src/rules/source-confidentiality.md +2 -0
- package/dist/agent-src/rules/source-of-truth.md +2 -0
- package/dist/agent-src/rules/telegraph-speak.md +2 -0
- package/dist/agent-src/rules/token-optimizer-maintenance.md +3 -1
- package/dist/agent-src/rules/tool-safety.md +4 -1
- package/dist/agent-src/rules/untrusted-input-defense.md +10 -0
- package/dist/agent-src/rules/verify-before-complete.md +2 -0
- package/dist/agent-src/skills/adr-create/SKILL.md +17 -1
- package/dist/agent-src/skills/agent-security-review/SKILL.md +1 -1
- package/dist/agent-src/skills/code-intelligence/SKILL.md +97 -0
- package/dist/agent-src/skills/condense-memory/SKILL.md +1 -1
- package/dist/agent-src/skills/corpus-grounding/SKILL.md +0 -3
- package/dist/agent-src/skills/description-assist/SKILL.md +1 -1
- package/dist/agent-src/skills/design-review/SKILL.md +5 -6
- package/dist/agent-src/skills/design-tokens/SKILL.md +0 -1
- package/dist/agent-src/skills/gated-reach/SKILL.md +185 -0
- package/dist/agent-src/skills/gated-reach/evals/triggers.json +72 -0
- package/dist/agent-src/skills/history-design/SKILL.md +101 -0
- package/dist/agent-src/skills/history-design/evals/triggers.json +17 -0
- package/dist/agent-src/skills/humanizer/SKILL.md +3 -3
- package/dist/agent-src/skills/image-analyser/SKILL.md +14 -12
- package/dist/agent-src/skills/image-editing/SKILL.md +2 -1
- package/dist/agent-src/skills/image-generation/SKILL.md +2 -1
- package/dist/agent-src/skills/image-provider-routing/SKILL.md +2 -2
- package/dist/agent-src/skills/launch-readiness/SKILL.md +1 -1
- package/dist/agent-src/skills/license-compliance-audit/SKILL.md +161 -0
- package/dist/agent-src/skills/license-compliance-audit/evals/triggers.json +52 -0
- package/dist/agent-src/skills/license-compliance-borrow-check/SKILL.md +145 -0
- package/dist/agent-src/skills/license-compliance-borrow-check/evals/triggers.json +52 -0
- package/dist/agent-src/skills/license-compliance-credits/SKILL.md +97 -0
- package/dist/agent-src/skills/license-compliance-credits/evals/triggers.json +52 -0
- package/dist/agent-src/skills/md-language-check/SKILL.md +1 -1
- package/dist/agent-src/skills/override-management/SKILL.md +1 -1
- package/dist/agent-src/skills/prediction-pool-optimizer/SKILL.md +7 -7
- package/dist/agent-src/skills/project-analysis-core/SKILL.md +1 -1
- package/dist/agent-src/skills/prompt-engineering-image/SKILL.md +3 -2
- package/dist/agent-src/skills/react-shadcn-ui/SKILL.md +2 -2
- package/dist/agent-src/skills/readme-writing/SKILL.md +6 -1
- package/dist/agent-src/skills/recursive-verification/SKILL.md +6 -0
- package/dist/agent-src/skills/refine-ticket/SKILL.md +3 -3
- package/dist/agent-src/skills/roadmap-writing/SKILL.md +4 -0
- package/dist/agent-src/skills/rtk-output-filtering/SKILL.md +31 -12
- package/dist/agent-src/skills/rule-refactor/SKILL.md +3 -3
- package/dist/agent-src/skills/schema-review/SKILL.md +92 -0
- package/dist/agent-src/skills/schema-review/evals/triggers.json +17 -0
- package/dist/agent-src/skills/screenshot-hygiene/SKILL.md +171 -0
- package/dist/agent-src/skills/secrets-management/SKILL.md +43 -1
- package/dist/agent-src/skills/security-audit/SKILL.md +1 -1
- package/dist/agent-src/skills/security-maturity-assessment/SKILL.md +1 -1
- package/dist/agent-src/skills/skill-improvement-pipeline/SKILL.md +3 -3
- package/dist/agent-src/skills/skill-writing/SKILL.md +2 -2
- package/dist/agent-src/skills/source-discovery/SKILL.md +5 -5
- package/dist/agent-src/skills/subagent-orchestration/SKILL.md +45 -85
- package/dist/agent-src/skills/subagent-orchestration/prompts/README.md +5 -4
- package/dist/agent-src/skills/subagent-orchestration/prompts/adversarial-verification-council.md +29 -0
- package/dist/agent-src/skills/subagent-orchestration/prompts/do-and-judge-two-stage.md +29 -0
- package/dist/agent-src/skills/subagent-orchestration/prompts/do-and-judge.md +29 -0
- package/dist/agent-src/skills/subagent-orchestration/prompts/do-competitively.md +29 -0
- package/dist/agent-src/skills/subagent-orchestration/prompts/do-in-parallel.md +29 -0
- package/dist/agent-src/skills/subagent-orchestration/prompts/do-in-steps.md +29 -0
- package/dist/agent-src/skills/subagent-orchestration/prompts/do-in-worktrees.md +29 -0
- package/dist/agent-src/skills/subagent-orchestration/prompts/judge-with-debate.md +29 -0
- package/dist/agent-src/skills/systematic-debugging/SKILL.md +2 -2
- package/dist/agent-src/skills/tailwind-engineer/SKILL.md +2 -3
- package/dist/agent-src/skills/token-optimizer/SKILL.md +4 -4
- package/dist/agent-src/skills/verify-repair-loop/SKILL.md +4 -0
- package/dist/agent-src/skills/worktree-lifecycle/SKILL.md +2 -3
- package/dist/agent-src/templates/AGENTS.md +1 -1
- package/dist/agent-src/templates/agents/.gitattributes.fragment +25 -6
- package/dist/agent-src/templates/agents/agent-project-settings.example.yml +1 -1
- package/dist/agent-src/templates/command.md +3 -3
- package/dist/agent-src/templates/github-workflows/secret-scan.yml +65 -0
- package/dist/agent-src/templates/persona.md +2 -2
- package/dist/agent-src/templates/rule.md +2 -2
- package/dist/agent-src/templates/scripts/telemetry/engagement.ts +77 -0
- package/dist/agent-src/templates/scripts/telemetry_record.ts +33 -1
- package/dist/cli/commands/doctorShell.js +20 -0
- package/dist/cli/commands/doctorShell.js.map +1 -1
- package/dist/cli/commands/rtkDetect.js +58 -0
- package/dist/cli/commands/rtkDetect.js.map +1 -0
- package/dist/cli/configRoot.js +112 -0
- package/dist/cli/configRoot.js.map +1 -0
- package/dist/cli/configRoot.test.js +97 -0
- package/dist/cli/configRoot.test.js.map +1 -0
- package/dist/cli/firstRunNotice.js +70 -0
- package/dist/cli/firstRunNotice.js.map +1 -0
- package/dist/cli/help.js +4 -1
- package/dist/cli/help.js.map +1 -1
- package/dist/cli/main.js +54 -5
- package/dist/cli/main.js.map +1 -1
- package/dist/cli/registry.js +8 -1
- package/dist/cli/registry.js.map +1 -1
- package/dist/discovery/deprecation-report.md +1 -1
- package/dist/discovery/discovery-manifest.json +502 -101
- package/dist/discovery/discovery-manifest.json.sha256 +1 -1
- package/dist/discovery/discovery-manifest.summary.md +6 -4
- package/dist/discovery/orphan-report.md +1 -1
- package/dist/discovery/packs.json +95 -8
- package/dist/discovery/trust-report.md +11 -11
- package/dist/discovery/workspaces.json +36 -7
- package/dist/hooks/dispatch.js +19475 -0
- package/dist/install/agentSwitchDetection.js +75 -0
- package/dist/install/agentSwitchDetection.js.map +1 -0
- package/dist/install/agentSwitchProfile.js +117 -0
- package/dist/install/agentSwitchProfile.js.map +1 -0
- package/dist/install/atomic.js +1 -1
- package/dist/install/detect.js +1 -1
- package/dist/install/install.mjs +791 -486
- package/dist/install/rtkDetection.js +213 -0
- package/dist/install/rtkDetection.js.map +1 -0
- package/dist/install/rule_scope.js +2 -1
- package/dist/install/rule_scope.js.map +1 -1
- package/dist/install/types.js +2 -2
- package/dist/install/wizard-plan.js +1 -1
- package/dist/install/wizardDismissals.js +58 -0
- package/dist/install/wizardDismissals.js.map +1 -0
- package/dist/mcp/awesome-mcp-servers.row.md +1 -1
- package/dist/mcp/mcp-cloudflare-catalogue.json +1 -1
- package/dist/mcp/registry-manifest.json +15 -4
- package/dist/mcp/server.json +20 -0
- package/dist/mcp/server.mjs +44292 -0
- package/dist/router.json +1 -1
- package/dist/scripts/condense.js +14 -7
- package/dist/scripts/condense.js.map +1 -1
- package/dist/server/app.js +12 -0
- package/dist/server/app.js.map +1 -1
- package/dist/server/io/sharedWriteCheck.js +101 -0
- package/dist/server/io/sharedWriteCheck.js.map +1 -0
- package/dist/server/routes/ping.js +32 -0
- package/dist/server/routes/ping.js.map +1 -1
- package/dist/server/routes/settings.js +21 -4
- package/dist/server/routes/settings.js.map +1 -1
- package/dist/server/routes/userMd.js +21 -4
- package/dist/server/routes/userMd.js.map +1 -1
- package/dist/server/routes/wizard.js +68 -25
- package/dist/server/routes/wizard.js.map +1 -1
- package/dist/server/schemas/settings.js +12 -2
- package/dist/server/schemas/settings.js.map +1 -1
- package/dist/server/serverInfo.js +6 -2
- package/dist/server/serverInfo.js.map +1 -1
- package/dist/server/token.js +11 -4
- package/dist/server/token.js.map +1 -1
- package/dist/server/writeRoot.js +15 -1
- package/dist/server/writeRoot.js.map +1 -1
- package/dist/shared/capabilities.js +33 -0
- package/dist/shared/capabilities.js.map +1 -0
- package/dist/shared/capabilities.test.js +39 -0
- package/dist/shared/capabilities.test.js.map +1 -0
- package/dist/ui/assets/index-BpSQt5vm.js +40 -0
- package/dist/ui/assets/index-BpSQt5vm.js.map +1 -0
- package/dist/ui/assets/index-jSfMW8_t.css +1 -0
- package/dist/ui/index.html +15 -6
- package/docs/MIGRATION.md +16 -0
- package/docs/guidelines/component-oriented-and-oop-development.md +4 -2
- package/package.json +22 -9
- package/src/agent-src/templates/AGENTS.md +1 -1
- package/src/agent-src/templates/scripts/telemetry/engagement.ts +77 -0
- package/src/agent-src/templates/scripts/telemetry_record.ts +33 -1
- package/src/config/agent-settings.template.yml +94 -13
- package/src/config/discovery/packs.yml +22 -0
- package/src/config/discovery/workspaces.yml +1 -1
- package/src/config/evaluator-budgets.json +47 -0
- package/src/config/hook-latency-budget.json +20 -0
- package/src/config/reach-channels.yml +217 -0
- package/src/config/reach-prescriptions-intake.yml +200 -0
- package/src/install/agentSwitchDetection.ts +90 -0
- package/src/install/agentSwitchProfile.ts +131 -0
- package/src/install/atomic.ts +1 -1
- package/src/install/detect.ts +1 -1
- package/src/install/rtkDetection.ts +274 -0
- package/src/install/rule_scope.ts +9 -2
- package/src/install/types.ts +2 -2
- package/src/install/wizard-plan.ts +1 -1
- package/src/install/wizardDismissals.ts +60 -0
- package/src/scripts/_cli/cmd_doctor.ts +62 -1
- package/src/scripts/_cli/cmd_memory_get.ts +197 -0
- package/src/scripts/_cli/cmd_refresh.ts +30 -0
- package/src/scripts/_dispatch.bash +96 -0
- package/src/scripts/_lib/auto_dispatch.corpus.test.ts +64 -1
- package/src/scripts/_lib/auto_dispatch.ts +76 -0
- package/src/scripts/_lib/detect_target_license.ts +714 -0
- package/src/scripts/_lib/exec_evidence.ts +251 -0
- package/src/scripts/_lib/fixtures/secret-detector/negatives.txt +15 -0
- package/src/scripts/_lib/fixtures/secret-detector/positives.txt +15 -0
- package/src/scripts/_lib/install_drift.ts +194 -0
- package/src/scripts/_lib/kernel_rules.ts +46 -0
- package/src/scripts/_lib/memory_fts_index.ts +390 -0
- package/src/scripts/_lib/orchestration_record.ts +91 -2
- package/src/scripts/_lib/persistence/adapter_raw_sql.ts +443 -0
- package/src/scripts/_lib/persistence/detect_audit_coverage.ts +423 -0
- package/src/scripts/_lib/persistence/detect_bounded_reads.ts +154 -0
- package/src/scripts/_lib/persistence/detect_index_parity.ts +576 -0
- package/src/scripts/_lib/persistence/detect_n1_eloquent.ts +226 -0
- package/src/scripts/_lib/persistence/detect_offload.ts +441 -0
- package/src/scripts/_lib/persistence/detect_prisma_growth.ts +74 -0
- package/src/scripts/_lib/persistence/offload_catalog.ts +73 -0
- package/src/scripts/_lib/persistence/types.ts +109 -0
- package/src/scripts/_lib/reddit_thread_parse.ts +598 -0
- package/src/scripts/_lib/risk_paths.ts +160 -0
- package/src/scripts/_lib/rtk_allowlist.ts +44 -0
- package/src/scripts/_lib/secret_detector.test.ts +108 -0
- package/src/scripts/_lib/secret_detector.ts +328 -0
- package/src/scripts/_lib/secret_detector_adversarial.test.ts +116 -0
- package/src/scripts/_lib/spawn_env.ts +7 -0
- package/src/scripts/_lib/sqlite_guard.ts +191 -0
- package/src/scripts/_lib/subagent_spawn.ts +53 -0
- package/src/scripts/_lib/tool_probe.ts +359 -0
- package/src/scripts/_lib/worker_budget.ts +107 -0
- package/src/scripts/adr/regenerate_index.ts +81 -6
- package/src/scripts/ai_council/blind_review.ts +0 -0
- package/src/scripts/ai_council/config.ts +12 -6
- package/src/scripts/ai_council/orchestrator.ts +73 -3
- package/src/scripts/ai_team/review_gate.ts +8 -10
- package/src/scripts/ai_team/team_dispatch.ts +48 -0
- package/src/scripts/audit_adr_coverage.ts +33 -0
- package/src/scripts/audit_initial_context.ts +1 -1
- package/src/scripts/bench_cross_source_eval.ts +400 -0
- package/src/scripts/bench_honesty_score.ts +1093 -0
- package/src/scripts/bench_hook_latency.ts +218 -0
- package/src/scripts/build_mcp_catalog.ts +275 -0
- package/src/scripts/build_mcp_registry_manifest.ts +46 -0
- package/src/scripts/build_proof.ts +207 -0
- package/src/scripts/chat_history.ts +8 -5
- package/src/scripts/check_adr_frontmatter.ts +195 -0
- package/src/scripts/check_artefact_count_messaging.ts +4 -0
- package/src/scripts/check_backstop_debt.ts +210 -0
- package/src/scripts/check_bundle_path_leakage.ts +343 -0
- package/src/scripts/check_claims.ts +188 -8
- package/src/scripts/check_comparison.ts +12 -0
- package/src/scripts/check_enforcement_coverage.ts +592 -0
- package/src/scripts/check_evaluator_budgets.ts +99 -0
- package/src/scripts/check_kernel_rule_bundle.ts +16 -12
- package/src/scripts/check_knowledge_sharing.ts +12 -1
- package/src/scripts/check_no_external_sources.ts +2 -2
- package/src/scripts/check_reach_channels.ts +407 -0
- package/src/scripts/check_reach_staleness.ts +364 -0
- package/src/scripts/check_secret_leak.test.ts +47 -0
- package/src/scripts/check_secret_leak.ts +290 -0
- package/src/scripts/check_source_pointer_freshness.ts +28 -3
- package/src/scripts/code_graph/build.ts +0 -0
- package/src/scripts/code_graph/cli.ts +379 -0
- package/src/scripts/code_graph/detect.ts +186 -0
- package/src/scripts/code_graph/extract.ts +386 -0
- package/src/scripts/code_graph/intent.ts +45 -0
- package/src/scripts/code_graph/loader.ts +123 -0
- package/src/scripts/code_graph/query.ts +290 -0
- package/src/scripts/code_graph/sanitize.ts +30 -0
- package/src/scripts/code_graph/sqlite_store.ts +174 -0
- package/src/scripts/code_graph/types.ts +83 -0
- package/src/scripts/code_graph/validate.ts +63 -0
- package/src/scripts/condense.ts +14 -6
- package/src/scripts/context_hygiene_hook.ts +8 -5
- package/src/scripts/council_cli.ts +126 -12
- package/src/scripts/detect_target_license.ts +203 -0
- package/src/scripts/evaluator_umbrella.sh +145 -0
- package/src/scripts/external_sources_denylist.json +8 -4
- package/src/scripts/first_run_gate_hook.ts +9 -5
- package/src/scripts/generate_subagent_floor.ts +194 -0
- package/src/scripts/hermetic-install.sh +3 -3
- package/src/scripts/hook_manifest.yaml +65 -16
- package/src/scripts/hooks/block_kernel_rule_writes.ts +212 -0
- package/src/scripts/hooks/block_no_verify.ts +9 -9
- package/src/scripts/hooks/code_graph_nudge_hook.ts +191 -0
- package/src/scripts/hooks/concern_registry.ts +75 -0
- package/src/scripts/hooks/design_slop_hook.ts +8 -5
- package/src/scripts/hooks/dispatch_entry.ts +37 -0
- package/src/scripts/hooks/dispatch_hook.ts +176 -3
- package/src/scripts/hooks/hook_stdin.ts +42 -0
- package/src/scripts/hooks/rtk_wrap_hook.ts +26 -12
- package/src/scripts/hot_context_hook.ts +7 -6
- package/src/scripts/injection_scan_hook.ts +9 -1
- package/src/scripts/install +6 -6
- package/src/scripts/install-hooks.sh +4 -4
- package/src/scripts/install.sh +5 -4
- package/src/scripts/install.ts +264 -23
- package/src/scripts/iron_law_sha.ts +3 -12
- package/src/scripts/learning_sidecar.ts +0 -0
- package/src/scripts/lint_budget_ownership.ts +89 -0
- package/src/scripts/lint_command_routing.ts +35 -5
- package/src/scripts/lint_command_verbs.ts +42 -9
- package/src/scripts/lint_consumer_internal_refs.ts +211 -0
- package/src/scripts/lint_discovery_vocabulary.ts +2 -0
- package/src/scripts/lint_documented_commands.ts +670 -0
- package/src/scripts/lint_framework_leakage.ts +17 -3
- package/src/scripts/lint_framework_leakage_allowlist.json +32 -0
- package/src/scripts/lint_governed_writes.ts +335 -0
- package/src/scripts/lint_hidden_unicode.ts +6 -0
- package/src/scripts/lint_mcp_registry_manifest.ts +26 -1
- package/src/scripts/lint_memory_tripwire.ts +186 -0
- package/src/scripts/lint_override_kernel_guard.ts +267 -0
- package/src/scripts/lint_persistence.ts +171 -0
- package/src/scripts/lint_pre_migration_refs.ts +106 -0
- package/src/scripts/lint_provenance.ts +547 -0
- package/src/scripts/lint_provenance_vocabulary.ts +437 -0
- package/src/scripts/lint_spawn_payload.ts +283 -0
- package/src/scripts/lint_store_boundary.ts +152 -0
- package/src/scripts/lint_versioned_cache.ts +7 -1
- package/src/scripts/mcp_server/__main__.ts +7 -2
- package/src/scripts/mcp_server/catalog.ts +23 -1
- package/src/scripts/mcp_server/consumer_tool_catalog.json +563 -193
- package/src/scripts/mcp_server/prompts.ts +6 -0
- package/src/scripts/mcp_server/tool_catalog_source.ts +332 -0
- package/src/scripts/mcp_server/tools.ts +56 -5
- package/src/scripts/mcp_telemetry_query.ts +2 -33
- package/src/scripts/mcp_telemetry_store.ts +64 -34
- package/src/scripts/measure_rule_budget.ts +3 -12
- package/src/scripts/memory_learn_hook.ts +126 -0
- package/src/scripts/memory_lookup.ts +0 -0
- package/src/scripts/memory_replay_24.ts +312 -0
- package/src/scripts/memory_report.ts +16 -3
- package/src/scripts/memory_signal.ts +48 -0
- package/src/scripts/memory_status.ts +6 -0
- package/src/scripts/minimal_safe_diff_hook.ts +8 -5
- package/src/scripts/onboarding_gate_hook.ts +8 -5
- package/src/scripts/orchestration_record.ts +16 -0
- package/src/scripts/pr_url_reminder_hook.ts +8 -1
- package/src/scripts/prepack-check.mjs +17 -0
- package/src/scripts/prepack_lifecycle_check.d.mts +8 -0
- package/src/scripts/prepack_lifecycle_check.mjs +82 -0
- package/src/scripts/profile_staleness_hook.ts +8 -7
- package/src/scripts/reach_doctor.ts +1651 -0
- package/src/scripts/release.ts +24 -3
- package/src/scripts/report_install_drift.ts +109 -0
- package/src/scripts/risk_escalation_shadow.ts +160 -0
- package/src/scripts/roadmap_progress_hook.ts +8 -5
- package/src/scripts/schemas/agent-settings.schema.json +23 -0
- package/src/scripts/schemas/license-policy.schema.json +89 -0
- package/src/scripts/schemas/provenance-borrow.schema.json +46 -0
- package/src/scripts/schemas/reach-channels.schema.json +134 -0
- package/src/scripts/schemas/reach-doctor-payload.schema.json +220 -0
- package/src/scripts/schemas/rule.schema.json +20 -0
- package/src/scripts/self_review_gate.test.ts +173 -1
- package/src/scripts/self_review_gate.ts +155 -15
- package/src/scripts/session_canary_hook.ts +182 -0
- package/src/scripts/skill_linter.ts +55 -0
- package/src/scripts/smoke_quickstart.ts +2 -2
- package/src/scripts/surface_probe_hook.ts +8 -7
- package/src/scripts/sync_gitattributes.ts +310 -0
- package/src/scripts/team_review_gate_hook.ts +13 -16
- package/src/scripts/validate_reach_prescriptions.ts +751 -0
- package/src/scripts/verify_before_complete_hook.ts +8 -5
- package/src/scripts/wrapper_freshness_hook.ts +8 -7
- package/src/server/schemas/settings.ts +24 -2
- package/src/shared/capabilities.test.ts +43 -0
- package/src/shared/capabilities.ts +75 -0
- package/src/templates/minimal/agents-overrides-readme.md +20 -0
- package/dist/ui/assets/index-BPFMZWUs.css +0 -1
- package/dist/ui/assets/index-BiEZiZ31.js +0 -40
- package/dist/ui/assets/index-BiEZiZ31.js.map +0 -1
- package/docs/CLAIMS.md +0 -261
- package/docs/DISTRIBUTION_CHECKLIST.md +0 -170
- package/docs/RELEASE_STORY_TEMPLATE.md +0 -37
- package/docs/SKILL_CENSUS.md +0 -352
- package/docs/adrs/cost/0001-hard-stop-hook.md +0 -114
- package/docs/adrs/cost/README.md +0 -9
- package/docs/adrs/memory/0001-consumer-side-snapshot.md +0 -119
- package/docs/adrs/memory/README.md +0 -10
- package/docs/adrs/router/0001-three-tier-routing.md +0 -119
- package/docs/adrs/router/README.md +0 -9
- package/docs/adrs/schema/0001-json-schema-frontmatter.md +0 -102
- package/docs/adrs/schema/README.md +0 -9
- package/docs/adrs/smoke/0001-per-tier-smoke-scripts.md +0 -99
- package/docs/adrs/smoke/README.md +0 -9
- package/docs/adrs/telegraph/0001-default-off-until-bench.md +0 -93
- package/docs/adrs/telegraph/README.md +0 -9
- package/docs/announcements/2026-05-non-dev-launch.md +0 -79
- package/docs/announcements/2026-07-honest-cost-sweep-launch.md +0 -84
- package/docs/anti-reskin-gate.md +0 -60
- package/docs/architecture/augment-projection.md +0 -70
- package/docs/architecture/claude-bundle.md +0 -77
- package/docs/architecture/current-onboard-baseline.md +0 -126
- package/docs/architecture/current-safety-behavior.md +0 -137
- package/docs/architecture/multi-tool-projection.md +0 -125
- package/docs/architecture/setup-vs-settings-shared-surface.md +0 -114
- package/docs/architecture/source-projection.md +0 -85
- package/docs/architecture.md +0 -390
- package/docs/archive/CHANGELOG-6.0.0-overview.md +0 -953
- package/docs/archive/CHANGELOG-7.0.0.md +0 -419
- package/docs/archive/CHANGELOG-pre-2.11.0.md +0 -141
- package/docs/archive/CHANGELOG-pre-2.15.0.md +0 -244
- package/docs/archive/CHANGELOG-pre-2.16.0.md +0 -48
- package/docs/archive/CHANGELOG-pre-2.17.0.md +0 -63
- package/docs/archive/CHANGELOG-pre-2.2.0.md +0 -2138
- package/docs/archive/CHANGELOG-pre-2.20.0.md +0 -159
- package/docs/archive/CHANGELOG-pre-2.25.0.md +0 -191
- package/docs/archive/CHANGELOG-pre-2.7.0.md +0 -185
- package/docs/archive/CHANGELOG-pre-3.0.0.md +0 -130
- package/docs/archive/CHANGELOG-pre-3.1.0.md +0 -167
- package/docs/archive/CHANGELOG-pre-3.2.0.md +0 -268
- package/docs/archive/CHANGELOG-pre-4.0.0.md +0 -80
- package/docs/archive/CHANGELOG-pre-4.5.0.md +0 -289
- package/docs/archive/CHANGELOG-pre-5.4.0.md +0 -260
- package/docs/archive/CHANGELOG-pre-5.9.0.md +0 -270
- package/docs/archive/CHANGELOG-pre-6.0.0.md +0 -473
- package/docs/archive/CHANGELOG-pre-7.0.0.md +0 -126
- package/docs/archive/CHANGELOG-pre-8.0.0.md +0 -301
- package/docs/archive/CHANGELOG-pre-8.1.0.md +0 -316
- package/docs/archive/CHANGELOG-pre-8.12.0.md +0 -304
- package/docs/archive/CHANGELOG-pre-8.9.0.md +0 -306
- package/docs/archive/CHANGELOG-pre-9.2.0.md +0 -276
- package/docs/artefact-census.md +0 -71
- package/docs/benchmark.md +0 -648
- package/docs/benchmark.pinned.yml +0 -31
- package/docs/benchmarks.md +0 -85
- package/docs/capability-matrix.md +0 -33
- package/docs/case-studies/_template.md +0 -60
- package/docs/case-studies/frontend-design-positioning.md +0 -86
- package/docs/catalog.md +0 -721
- package/docs/command-flows.md +0 -272
- package/docs/command-naming-audit.md +0 -60
- package/docs/comparison.yaml +0 -45
- package/docs/contracts/CHANGELOG-conventions.md +0 -149
- package/docs/contracts/STABILITY.md +0 -188
- package/docs/contracts/adoption-signal-floor.md +0 -127
- package/docs/contracts/adr-architectural-consensus-mechanism.md +0 -68
- package/docs/contracts/adr-chat-history-split.md +0 -140
- package/docs/contracts/adr-command-suggestion.md +0 -144
- package/docs/contracts/adr-forecast-construction-shape.md +0 -90
- package/docs/contracts/adr-gtm-context-spine.md +0 -116
- package/docs/contracts/adr-implement-ticket-runtime.md +0 -121
- package/docs/contracts/adr-install-user-type-axis.md +0 -107
- package/docs/contracts/adr-layout.md +0 -107
- package/docs/contracts/adr-level-6-productization.md +0 -145
- package/docs/contracts/adr-mcp-runtime.md +0 -128
- package/docs/contracts/adr-product-ui-track.md +0 -381
- package/docs/contracts/adr-prompt-driven-execution.md +0 -186
- package/docs/contracts/adr-settings-sync-engine.md +0 -128
- package/docs/contracts/adr-user-types-axis.md +0 -127
- package/docs/contracts/adr-wing4-context-spine.md +0 -126
- package/docs/contracts/agent-user-schema.md +0 -170
- package/docs/contracts/agents-layout.md +0 -148
- package/docs/contracts/agents-md-tech-stack.md +0 -75
- package/docs/contracts/ai-council-config.md +0 -829
- package/docs/contracts/ai-team-config.md +0 -224
- package/docs/contracts/analysis-memory-loop.md +0 -149
- package/docs/contracts/at-rest-encryption.md +0 -191
- package/docs/contracts/audit-log-v1.md +0 -150
- package/docs/contracts/auto-orchestration-v1.md +0 -70
- package/docs/contracts/benchmark-ab-contract.md +0 -106
- package/docs/contracts/benchmark-corpus-spec.md +0 -125
- package/docs/contracts/benchmark-report-schema.md +0 -113
- package/docs/contracts/branch-protection-policy.md +0 -139
- package/docs/contracts/brand-token-consumption.md +0 -74
- package/docs/contracts/capability-boundary.md +0 -69
- package/docs/contracts/capability-packs.md +0 -217
- package/docs/contracts/ci-cost-budget.md +0 -111
- package/docs/contracts/ci-green-floor.md +0 -141
- package/docs/contracts/command-category-governance.md +0 -84
- package/docs/contracts/command-clusters.md +0 -399
- package/docs/contracts/command-surface-tiers.md +0 -176
- package/docs/contracts/command-taxonomy.md +0 -137
- package/docs/contracts/condensation-default-kill-criterion.md +0 -116
- package/docs/contracts/config-presets.md +0 -144
- package/docs/contracts/conformance.md +0 -84
- package/docs/contracts/consumer-bridge.md +0 -73
- package/docs/contracts/context-paths.md +0 -101
- package/docs/contracts/context-spine.md +0 -179
- package/docs/contracts/cost-dashboard.md +0 -143
- package/docs/contracts/cost-enforcement.md +0 -134
- package/docs/contracts/cost-profile-defaults.md +0 -110
- package/docs/contracts/cost-summary-schema.md +0 -107
- package/docs/contracts/creative-pack-boundary.md +0 -63
- package/docs/contracts/cross-repo-retrieval.md +0 -64
- package/docs/contracts/cross-wing-handoff.md +0 -134
- package/docs/contracts/daily-workspace.md +0 -147
- package/docs/contracts/decision-engine-gates.md +0 -120
- package/docs/contracts/decision-trace-v1.md +0 -177
- package/docs/contracts/design-artifact-lifecycle.md +0 -93
- package/docs/contracts/design-artifact-verification.md +0 -153
- package/docs/contracts/discovery-manifest.md +0 -209
- package/docs/contracts/discovery-manifest.schema.json +0 -254
- package/docs/contracts/evidence-based-pruning.md +0 -102
- package/docs/contracts/explain-modes.md +0 -187
- package/docs/contracts/explain-trace.schema.json +0 -144
- package/docs/contracts/file-ownership-matrix.json +0 -13941
- package/docs/contracts/file-ownership-matrix.md +0 -135
- package/docs/contracts/frontmatter-contract.md +0 -140
- package/docs/contracts/ghostwriter-schema.md +0 -337
- package/docs/contracts/governance-enforcement-projection.md +0 -159
- package/docs/contracts/gui-wizard.md +0 -350
- package/docs/contracts/harness-expectations.md +0 -128
- package/docs/contracts/hook-architecture-v1.md +0 -325
- package/docs/contracts/host-agent-protocol.md +0 -110
- package/docs/contracts/implement-ticket-flow.md +0 -625
- package/docs/contracts/init-telemetry.md +0 -132
- package/docs/contracts/injected-block-authenticity-model.md +0 -66
- package/docs/contracts/install-layout.md +0 -249
- package/docs/contracts/install-scopes.md +0 -82
- package/docs/contracts/installed-tools-lockfile.md +0 -144
- package/docs/contracts/installer-agent-mode.md +0 -137
- package/docs/contracts/iron-law-overrides.txt +0 -26
- package/docs/contracts/kernel-membership.md +0 -339
- package/docs/contracts/linear-ai-rules-inclusion.md +0 -143
- package/docs/contracts/linear-ai-three-layers.md +0 -130
- package/docs/contracts/linter-structural-model.md +0 -181
- package/docs/contracts/load-context-budget-model.md +0 -259
- package/docs/contracts/load-context-schema.md +0 -220
- package/docs/contracts/local-analytics.md +0 -160
- package/docs/contracts/local-knowledge-ingestion.md +0 -96
- package/docs/contracts/local-server-api.md +0 -134
- package/docs/contracts/low-impact-corpus-format.md +0 -95
- package/docs/contracts/mcp-beta-criteria.md +0 -130
- package/docs/contracts/mcp-cloud-scope.md +0 -355
- package/docs/contracts/mcp-discovery-phase-notice.md +0 -60
- package/docs/contracts/mcp-phase-1-scope.md +0 -272
- package/docs/contracts/mcp-registry-manifest.schema.json +0 -129
- package/docs/contracts/mcp-tool-inventory.md +0 -64
- package/docs/contracts/mcp-tool-stub-envelope.md +0 -78
- package/docs/contracts/measurement-baseline.md +0 -103
- package/docs/contracts/memory-visibility-v1.md +0 -160
- package/docs/contracts/mental-models.md +0 -336
- package/docs/contracts/migrate-command.md +0 -233
- package/docs/contracts/multi-tool-projection-fidelity.md +0 -134
- package/docs/contracts/namespace.md +0 -125
- package/docs/contracts/no-runtime-boundary.md +0 -61
- package/docs/contracts/one-off-script-lifecycle.md +0 -110
- package/docs/contracts/orchestration-dsl-v1.md +0 -153
- package/docs/contracts/package-self-orientation.md +0 -163
- package/docs/contracts/pilot/agent-authority.md +0 -24
- package/docs/contracts/pilot/direct-answers.md +0 -70
- package/docs/contracts/pilot/language-and-tone.md +0 -63
- package/docs/contracts/plain-language-surface.md +0 -117
- package/docs/contracts/prelaunch-diagnostics.md +0 -151
- package/docs/contracts/profile-system.md +0 -167
- package/docs/contracts/reasoning-discipline-protocol.md +0 -83
- package/docs/contracts/release-pr-gating.md +0 -151
- package/docs/contracts/release-sizing.md +0 -107
- package/docs/contracts/release-trunk-sync.md +0 -105
- package/docs/contracts/review-lens-schema.md +0 -64
- package/docs/contracts/roadmap-complexity-standard.md +0 -138
- package/docs/contracts/role-experience.md +0 -125
- package/docs/contracts/router-blending.md +0 -71
- package/docs/contracts/rule-classification.md +0 -171
- package/docs/contracts/rule-interactions.md +0 -132
- package/docs/contracts/rule-interactions.yml +0 -260
- package/docs/contracts/rule-priority-hierarchy.md +0 -88
- package/docs/contracts/rule-router.md +0 -287
- package/docs/contracts/safety-model.md +0 -129
- package/docs/contracts/session-profile-overlay.md +0 -157
- package/docs/contracts/settings-api.md +0 -264
- package/docs/contracts/settings-gui-agent-mode.schema.json +0 -128
- package/docs/contracts/settings-sync-yaml-subset.md +0 -139
- package/docs/contracts/skill-bundled-assets.md +0 -62
- package/docs/contracts/skill-discovery.md +0 -80
- package/docs/contracts/skill-distribution-channels.md +0 -66
- package/docs/contracts/skill-domains.md +0 -144
- package/docs/contracts/skill-dry-run.md +0 -47
- package/docs/contracts/skill-family-map.yml +0 -915
- package/docs/contracts/smoke-contracts.md +0 -144
- package/docs/contracts/subagent-boundary.md +0 -59
- package/docs/contracts/surface-agent-contracts.md +0 -153
- package/docs/contracts/surface-matrix.md +0 -108
- package/docs/contracts/surface-tiers.md +0 -81
- package/docs/contracts/telegraph-telemetry.md +0 -83
- package/docs/contracts/ticket-bundle-format.md +0 -233
- package/docs/contracts/tier-3-contrib-plugin.md +0 -137
- package/docs/contracts/trust-and-safety.md +0 -144
- package/docs/contracts/ui-stack-extension.md +0 -237
- package/docs/contracts/ui-track-flow.md +0 -329
- package/docs/contracts/universal-skills.md +0 -91
- package/docs/contracts/user-type-schema.md +0 -146
- package/docs/contracts/value-dashboard-spec.md +0 -378
- package/docs/contracts/value-report-schema.md +0 -168
- package/docs/contracts/workflow-packs.md +0 -121
- package/docs/contracts/workspace-boundary.md +0 -84
- package/docs/contracts/workspace-documents.md +0 -144
- package/docs/contracts/write-engine.md +0 -182
- package/docs/cookbook.md +0 -152
- package/docs/customization.md +0 -685
- package/docs/decisions/ADR-001-kernel-swap-deferred.md +0 -109
- package/docs/decisions/ADR-002-kernel-bucket-overrides.md +0 -135
- package/docs/decisions/ADR-003-flat-cluster-subs-and-colon-syntax.md +0 -137
- package/docs/decisions/ADR-004-rule-governance-pruning.md +0 -240
- package/docs/decisions/ADR-005-subagent-worktrees.md +0 -120
- package/docs/decisions/ADR-006-skill-tools-python-pilot.md +0 -114
- package/docs/decisions/ADR-007-agent-discovery-scopes.md +0 -371
- package/docs/decisions/ADR-008-installed-tools-manifest.md +0 -160
- package/docs/decisions/ADR-009-event4u-namespace.md +0 -188
- package/docs/decisions/ADR-010-profile-pack-preset-boundary.md +0 -168
- package/docs/decisions/ADR-011-domain-pack-readiness.md +0 -213
- package/docs/decisions/ADR-012-typescript-cli-shell.md +0 -162
- package/docs/decisions/ADR-013-discovery-frontmatter-contract.md +0 -342
- package/docs/decisions/ADR-014-gui-framework-choice.md +0 -136
- package/docs/decisions/ADR-015-discovery-manifest-contract.md +0 -146
- package/docs/decisions/ADR-016-installer-architecture.md +0 -189
- package/docs/decisions/ADR-017-monorepo-physical-layout.md +0 -261
- package/docs/decisions/ADR-018-trust-and-safety-layer.md +0 -159
- package/docs/decisions/ADR-019-router-json-dist-location.md +0 -124
- package/docs/decisions/ADR-020-global-only-consumer-scope.md +0 -213
- package/docs/decisions/ADR-021-deployment-shape.md +0 -153
- package/docs/decisions/ADR-022-daily-workspace-decomposition.md +0 -140
- package/docs/decisions/ADR-023-host-agent-protocol.md +0 -129
- package/docs/decisions/ADR-024-workspace-v0-feature-floor.md +0 -126
- package/docs/decisions/ADR-025-workspace-chrome.md +0 -119
- package/docs/decisions/ADR-026-explain-mode-translation.md +0 -117
- package/docs/decisions/ADR-027-changelog-machine-vs-manual.md +0 -129
- package/docs/decisions/ADR-028-root-layout.md +0 -147
- package/docs/decisions/ADR-029-multi-workspace-deferred.md +0 -122
- package/docs/decisions/ADR-030-claude-code-command-projection.md +0 -147
- package/docs/decisions/ADR-031-validation-severity-tiers-and-projection-roundtrip.md +0 -97
- package/docs/decisions/ADR-032-linked-projects-scope.md +0 -122
- package/docs/decisions/ADR-033-distribution-identity-npm-primary.md +0 -81
- package/docs/decisions/ADR-034-per-skill-model-recommendation-transport.md +0 -63
- package/docs/decisions/ADR-035-model-capability-tiers.md +0 -104
- package/docs/decisions/ADR-036-global-install-browser-wizard-handoff.md +0 -106
- package/docs/decisions/ADR-037-cost-profile-untangle.md +0 -117
- package/docs/decisions/ADR-038-canonical-settings-path.md +0 -96
- package/docs/decisions/ADR-039-claude-skills-untracked.md +0 -139
- package/docs/decisions/ADR-040-execution-model-projection-time-filtering.md +0 -244
- package/docs/decisions/ADR-041-controlled-command-verbs.md +0 -133
- package/docs/decisions/ADR-042-runtime-resolver-decision-gate.md +0 -113
- package/docs/decisions/ADR-043-monorepo-collapse-to-src-domains.md +0 -128
- package/docs/decisions/ADR-044-command-naming-scheme-hyphenated.md +0 -250
- package/docs/decisions/ADR-045-src-source-layout-and-profiles-as-views.md +0 -111
- package/docs/decisions/ADR-046-thin-command-principle.md +0 -93
- package/docs/decisions/ADR-047-framework-neutral-stack-adaptive-commands.md +0 -94
- package/docs/decisions/ADR-048-command-justification-rule.md +0 -106
- package/docs/decisions/ADR-049-configuration-trust-boundary.md +0 -132
- package/docs/decisions/ADR-050-workspace-vs-package-root-boundary.md +0 -121
- package/docs/decisions/ADR-051-uncondensed-source-container-relocation.md +0 -114
- package/docs/decisions/ADR-052-packages-removal-and-pack-home-migration.md +0 -86
- package/docs/decisions/ADR-053-agents-namespace-dual-role-resolution.md +0 -132
- package/docs/decisions/ADR-054-rule-adherence-decay-triggered-restate.md +0 -143
- package/docs/decisions/ADR-055-flow-layer-data-model.md +0 -235
- package/docs/decisions/ADR-056-unvalidated-video-adapters-disposition.md +0 -124
- package/docs/decisions/ADR-057-consolidation-evidence-gate-outcomes.md +0 -135
- package/docs/decisions/ADR-058-condensed-output-relocation-to-dist.md +0 -94
- package/docs/decisions/ADR-059-render-resume-filesystem-as-state.md +0 -161
- package/docs/decisions/ADR-060-comfyui-sandbox-model.md +0 -154
- package/docs/decisions/ADR-061-corpus-grounding-layer.md +0 -230
- package/docs/decisions/ADR-062-encrypt-at-rest-store-architecture.md +0 -121
- package/docs/decisions/ADR-063-append-jsonl-encryption-deferred.md +0 -83
- package/docs/decisions/ADR-064-append-jsonl-per-record-encryption.md +0 -113
- package/docs/decisions/ADR-065-tier3-inbox-handoff-v0.md +0 -86
- package/docs/decisions/ADR-066-skill-body-prerendering.md +0 -93
- package/docs/decisions/ADR-067-glama-registry-listing.md +0 -259
- package/docs/decisions/ADR-068-host-tier-detection.md +0 -90
- package/docs/decisions/ADR-069-prompt-renderer.md +0 -97
- package/docs/decisions/ADR-070-tier1-drive-loop.md +0 -94
- package/docs/decisions/ADR-071-launch-drive-integration.md +0 -95
- package/docs/decisions/ADR-072-codex-gemini-drive-configs.md +0 -90
- package/docs/decisions/ADR-073-drive-health-kill-switch.md +0 -81
- package/docs/decisions/ADR-074-drive-kill-switch-auto-recovery.md +0 -84
- package/docs/decisions/ADR-075-workspace-gui-drive.md +0 -83
- package/docs/decisions/ADR-076-workspace-multi-turn.md +0 -92
- package/docs/decisions/ADR-077-workspace-followup-gui.md +0 -70
- package/docs/decisions/ADR-078-drive-health-panel.md +0 -70
- package/docs/decisions/ADR-079-workspace-host-picker.md +0 -81
- package/docs/decisions/ADR-080-host-session-expired-410.md +0 -92
- package/docs/decisions/ADR-081-drive-health-reset-and-410-affordance.md +0 -71
- package/docs/decisions/ADR-082-410-one-click-relaunch.md +0 -58
- package/docs/decisions/ADR-083-session-thread-and-arbitrary-continuation.md +0 -85
- package/docs/decisions/ADR-084-drive-health-refresh-on-drive.md +0 -52
- package/docs/decisions/ADR-085-mcp-stdio-end-user-distribution-shape.md +0 -158
- package/docs/decisions/ADR-086-read-only-cross-agent-mcp-discovery-helper.md +0 -171
- package/docs/decisions/ADR-087-installer-e2e-test-strategy.md +0 -111
- package/docs/decisions/ADR-088-no-external-runtime-federation.md +0 -144
- package/docs/decisions/ADR-089-lean-local-plugin-install.md +0 -111
- package/docs/decisions/ADR-090-visibility-command-frontmatter-field.md +0 -95
- package/docs/decisions/ADR-091-split-meta-capability-packs.md +0 -113
- package/docs/decisions/ADR-092-defer-command-tier-alias-removal.md +0 -117
- package/docs/decisions/ADR-093-ai-council-config-user-global.md +0 -117
- package/docs/decisions/ADR-094-agent-memory-layer-removal.md +0 -94
- package/docs/decisions/ADR-095-workspace-boundary-contract.md +0 -108
- package/docs/decisions/ADR-096-analysis-workbench.md +0 -110
- package/docs/decisions/ADR-097-mission-recipe-privilege-boundary.md +0 -121
- package/docs/decisions/ADR-098-evidence-first-structure-discovery.md +0 -154
- package/docs/decisions/ADR-099-file-first-pattern-library.md +0 -87
- package/docs/decisions/ADR-100-global-knowledge-card-sharing.md +0 -140
- package/docs/decisions/ADR-101-ticket-bundle-emission.md +0 -109
- package/docs/decisions/ADR-102-ticket-handoff-paste-and-mcp.md +0 -72
- package/docs/decisions/ADR-103-global-knowledge-default-off-until-measured.md +0 -92
- package/docs/decisions/ADR-104-ai-council-config-global-only.md +0 -119
- package/docs/decisions/ADR-105-automatic-subagent-orchestration.md +0 -108
- package/docs/decisions/ADR-106-recursive-verification-benchmark-gate.md +0 -126
- package/docs/decisions/ADR-107-legal-domain-pack-adoption.md +0 -70
- package/docs/decisions/ADR-108-open-source-forever-no-commercial-tier.md +0 -46
- package/docs/decisions/ADR-109-subagent-v1-contract.md +0 -246
- package/docs/decisions/ADR-110-discipline-profile-resolution-locus.md +0 -110
- package/docs/decisions/ADR-111-canonical-glama-listing.md +0 -97
- package/docs/decisions/ADR-112-stdio-lite-stays-read-only.md +0 -92
- package/docs/decisions/ADR-113-ci-native-release-label-trigger.md +0 -201
- package/docs/decisions/ADR-114-commit-policy-iron-law-override.md +0 -85
- package/docs/decisions/ADR-115-command-cluster-consolidation-phase-4.md +0 -91
- package/docs/decisions/ADR-116-memory-tripwire-activation-path.md +0 -144
- package/docs/decisions/ADR-117-subagents-auto-default-on.md +0 -89
- package/docs/decisions/ADR-118-loop-engineering-boundaries.md +0 -162
- package/docs/decisions/ADR-119-global-knowledge-default-on.md +0 -104
- package/docs/decisions/ADR-120-council-chairman-mode.md +0 -70
- package/docs/decisions/ADR-121-knowledge-sensitivity-classes.md +0 -90
- package/docs/decisions/ADR-122-adversarial-verification-council.md +0 -166
- package/docs/decisions/ADR-123-runtime-security-scope-and-spawn-hardening.md +0 -142
- package/docs/decisions/ADR-200-python-to-typescript-migration.md +0 -203
- package/docs/decisions/ADR-rule-kernel-and-router.md +0 -133
- package/docs/decisions/INDEX.md +0 -136
- package/docs/deploy/connector-setup.md +0 -129
- package/docs/deploy/env-vars.md +0 -70
- package/docs/deploy/policy-cookbook.md +0 -130
- package/docs/deploy/quickstart.md +0 -112
- package/docs/deploy/small-team-recipe.md +0 -148
- package/docs/deploy/team-deployment-posture.md +0 -111
- package/docs/design/adversarial-council-eval.md +0 -106
- package/docs/design/council-vs-solo-baseline.md +0 -92
- package/docs/design/cross-model-parity-eval.md +0 -82
- package/docs/design/length-neutral-judge-rerun.md +0 -92
- package/docs/design/utilization-window-criteria.md +0 -51
- package/docs/development.md +0 -230
- package/docs/distribution/awesome-list-submission.md +0 -46
- package/docs/distribution/consumer-matrix.md +0 -96
- package/docs/distribution/launch-story-draft.md +0 -58
- package/docs/distribution/mcp-submission-checklist.md +0 -95
- package/docs/distribution/public-install-smoke.md +0 -68
- package/docs/distribution/registries.md +0 -117
- package/docs/distribution/registry-submissions.md +0 -85
- package/docs/distribution/telemetry-privacy.md +0 -128
- package/docs/distribution/telemetry-schema.md +0 -174
- package/docs/distribution/topics-equivalents-decay-policy.md +0 -51
- package/docs/end-to-end-walkthroughs.md +0 -165
- package/docs/enforcement-by-host.md +0 -44
- package/docs/examples/agent-user.example.md +0 -22
- package/docs/experiences/agency.md +0 -49
- package/docs/experiences/content_creator.md +0 -49
- package/docs/experiences/developer.md +0 -49
- package/docs/experiences/finance.md +0 -50
- package/docs/experiences/founder.md +0 -49
- package/docs/experiences/ops.md +0 -49
- package/docs/featured-commands.md +0 -27
- package/docs/featured-skills.md +0 -95
- package/docs/flows.md +0 -67
- package/docs/getting-started-by-role.md +0 -190
- package/docs/getting-started-laravel.md +0 -72
- package/docs/getting-started-local-stdio.md +0 -77
- package/docs/getting-started.md +0 -254
- package/docs/github-topics.md +0 -93
- package/docs/governance-advantage.md +0 -72
- package/docs/governance.md +0 -96
- package/docs/guides/cross-repo-linked-projects.md +0 -93
- package/docs/guides/cross-repo-retrieval.md +0 -61
- package/docs/guides/frontend-design-corpus-refresh.md +0 -83
- package/docs/guides/local-analytics.md +0 -125
- package/docs/guides/local-knowledge.md +0 -127
- package/docs/guides/skill-discovery.md +0 -71
- package/docs/guides/skill-preview.md +0 -71
- package/docs/hook-payload-capture.md +0 -221
- package/docs/install-friction-report.md +0 -66
- package/docs/installation.md +0 -959
- package/docs/maintainers/branch-protection.md +0 -105
- package/docs/maintainers/dev-mode.md +0 -106
- package/docs/maintainers/optional-media-deps.md +0 -50
- package/docs/maintainers/system-map.md +0 -85
- package/docs/mcp-registries.md +0 -94
- package/docs/mcp-server.md +0 -175
- package/docs/mcp.md +0 -147
- package/docs/media/proof-demo.cast +0 -14
- package/docs/media/proof-demo.gif +0 -0
- package/docs/migration/consumer-template-consumption-model.md +0 -145
- package/docs/migration/divergences/README.md +0 -55
- package/docs/migration/divergences/_template.md +0 -50
- package/docs/migration/divergences/bench-stats-float-precision.md +0 -72
- package/docs/migration/divergences/mcp-telemetry-node-sqlite.md +0 -61
- package/docs/migration/divergences/pack-mcp-content-gzip-body.md +0 -53
- package/docs/migration/divergences/src-scripts-build_cloud_bundle.md +0 -63
- package/docs/migration/divergences/src-scripts-check_memory.md +0 -91
- package/docs/migration/divergences/src-scripts-inventory_abstraction_budget.md +0 -65
- package/docs/migration/divergences/src-scripts-lint_marketplace.md +0 -57
- package/docs/migration/divergences/src-scripts-lint_mcp_registry_manifest.md +0 -70
- package/docs/migration/divergences/src-scripts-spotcheck_thin_root.md +0 -60
- package/docs/migration/divergences/src-scripts-validate_agent_settings.md +0 -58
- package/docs/migration/node-floor.md +0 -86
- package/docs/migration/v1-to-v2.md +0 -156
- package/docs/migration/yaml-roundtrip-spike.md +0 -163
- package/docs/migrations/commands-1.15.0.md +0 -117
- package/docs/parity/bench-external.json +0 -58
- package/docs/parity/bench.json +0 -41
- package/docs/parity/command-frontmatter.md +0 -60
- package/docs/parity/external-runtime.md +0 -46
- package/docs/personas.md +0 -178
- package/docs/positioning-evidence.md +0 -86
- package/docs/profiles.md +0 -108
- package/docs/proof.md +0 -176
- package/docs/quality.md +0 -98
- package/docs/readme-split-plan.md +0 -102
- package/docs/recruits/_template.md +0 -81
- package/docs/release-runbook.md +0 -141
- package/docs/role-experiences.md +0 -19
- package/docs/safety.md +0 -30
- package/docs/second-brain-scope.md +0 -116
- package/docs/self-review-gate.md +0 -65
- package/docs/setup/enterprise-and-offline.md +0 -201
- package/docs/setup/mcp-client-config.md +0 -358
- package/docs/setup/mcp-cloud-endpoints.md +0 -116
- package/docs/setup/mcp-cloud-registry-listing.md +0 -99
- package/docs/setup/mcp-cloud-setup.md +0 -183
- package/docs/setup/mcp-r2-bootstrap.md +0 -82
- package/docs/setup/mcp-server-docker.md +0 -101
- package/docs/setup/per-ide/aider.md +0 -48
- package/docs/setup/per-ide/antigravity.md +0 -68
- package/docs/setup/per-ide/augment.md +0 -89
- package/docs/setup/per-ide/claude-code.md +0 -97
- package/docs/setup/per-ide/claude-desktop.md +0 -207
- package/docs/setup/per-ide/cline.md +0 -43
- package/docs/setup/per-ide/codebuddy.md +0 -63
- package/docs/setup/per-ide/codex.md +0 -46
- package/docs/setup/per-ide/continue.md +0 -68
- package/docs/setup/per-ide/copilot.md +0 -80
- package/docs/setup/per-ide/cursor.md +0 -125
- package/docs/setup/per-ide/droid.md +0 -65
- package/docs/setup/per-ide/gemini-cli.md +0 -45
- package/docs/setup/per-ide/jetbrains.md +0 -76
- package/docs/setup/per-ide/kilocode.md +0 -66
- package/docs/setup/per-ide/kiro.md +0 -72
- package/docs/setup/per-ide/opencode.md +0 -62
- package/docs/setup/per-ide/qoder.md +0 -63
- package/docs/setup/per-ide/roocode.md +0 -68
- package/docs/setup/per-ide/trae.md +0 -63
- package/docs/setup/per-ide/warp.md +0 -63
- package/docs/setup/per-ide/windsurf.md +0 -109
- package/docs/setup/per-ide/zed.md +0 -73
- package/docs/showcase.md +0 -209
- package/docs/skill-duplication-findings.md +0 -91
- package/docs/skills-catalog.md +0 -265
- package/docs/skills-taxonomy.md +0 -90
- package/docs/spawn-site-policy.md +0 -72
- package/docs/succession.md +0 -80
- package/docs/threat-model.md +0 -29
- package/docs/troubleshooting.md +0 -155
- package/docs/ui-track-mental-model.md +0 -121
- package/docs/us-vs-the-category.md +0 -38
- package/docs/value.md +0 -86
- package/docs/walkthroughs/assets/workspace-role-grid.png +0 -0
- package/docs/walkthroughs/assets/workspace-session-started.png +0 -0
- package/docs/walkthroughs/assets/workspace-task-picker.png +0 -0
- package/docs/walkthroughs/daily-workspace-a11y.md +0 -87
- package/docs/walkthroughs/daily-workspace.md +0 -127
- package/docs/wedge/production-validator/README.md +0 -81
- package/docs/wedge/production-validator/first-run-check.sh +0 -42
- package/docs/wedge/production-validator/production-validator.md +0 -83
- package/docs/wizard.md +0 -173
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
{
|
|
2
|
+
"skill": "gated-reach",
|
|
3
|
+
"last_eval": "2026-07-25",
|
|
4
|
+
"description": "6 should-trigger + 8 should-not-trigger queries. Should-trigger covers DE + EN phrasings for the two ship-tier intents only: reading a Reddit thread (text, and ranking/structure) and reading a single named tweet. Should-not-trigger is deliberately larger than the positive set: the parent bench found the native web tools already win on ordinary research, so this skill's main failure mode is over-triggering. Negatives cover general research, plain web pages, the parked YouTube channel, unsupported Twitter surfaces (timelines/search), and an unsupported platform — a trigger that fires only to decline is worse than no trigger.",
|
|
5
|
+
"queries": [
|
|
6
|
+
{
|
|
7
|
+
"q": "what does this reddit thread say? https://www.reddit.com/r/rust/comments/abc123/",
|
|
8
|
+
"trigger": true
|
|
9
|
+
},
|
|
10
|
+
{
|
|
11
|
+
"q": "which comment did people actually upvote in this reddit discussion?",
|
|
12
|
+
"trigger": true,
|
|
13
|
+
"note": "ranking intent — tier 2, the credential-free capability this roadmap shipped"
|
|
14
|
+
},
|
|
15
|
+
{
|
|
16
|
+
"q": "reddit.com wird von deinem web-tool abgelehnt — lies mir den Thread trotzdem vor",
|
|
17
|
+
"trigger": true
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
"q": "summarise the top comments and their scores on this r/programming post",
|
|
21
|
+
"trigger": true
|
|
22
|
+
},
|
|
23
|
+
{
|
|
24
|
+
"q": "what does this tweet say? https://x.com/somesmallaccount/status/1964428927159382261",
|
|
25
|
+
"trigger": true
|
|
26
|
+
},
|
|
27
|
+
{
|
|
28
|
+
"q": "x.com gibt 402 zurück — was steht in diesem Tweet?",
|
|
29
|
+
"trigger": true
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"q": "research the current best practice for database connection pooling",
|
|
33
|
+
"trigger": false,
|
|
34
|
+
"note": "ordinary dev research — native web tools win 12/12 (parent bench null)"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"q": "fetch this blog post and summarise it",
|
|
38
|
+
"trigger": false,
|
|
39
|
+
"note": "plain web page — the host's own fetch handles it"
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"q": "get me the transcript of this YouTube video",
|
|
43
|
+
"trigger": false,
|
|
44
|
+
"note": "youtube-transcripts is PARKED — backend absent by design; reach:doctor states it"
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
"q": "pull this user's recent twitter timeline",
|
|
48
|
+
"trigger": false,
|
|
49
|
+
"note": "no credential-free path to timelines — not a shipped intent"
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
"q": "search twitter for mentions of our product",
|
|
53
|
+
"trigger": false,
|
|
54
|
+
"note": "no credential-free path to search — not a shipped intent"
|
|
55
|
+
},
|
|
56
|
+
{
|
|
57
|
+
"q": "read this Weibo thread for me",
|
|
58
|
+
"trigger": false,
|
|
59
|
+
"note": "no prescription exists for CN platforms — declining is not a trigger"
|
|
60
|
+
},
|
|
61
|
+
{
|
|
62
|
+
"q": "what are the open issues on this GitHub repo?",
|
|
63
|
+
"trigger": false,
|
|
64
|
+
"note": "the github channel is a separate, already-working surface"
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
"q": "install yt-dlp for me so the youtube channel works",
|
|
68
|
+
"trigger": false,
|
|
69
|
+
"note": "the package never auto-installs — missing-tool-handling, not this skill"
|
|
70
|
+
}
|
|
71
|
+
]
|
|
72
|
+
}
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
---
|
|
2
|
+
model_tier: medium
|
|
3
|
+
name: history-design
|
|
4
|
+
description: "Use when choosing HOW to record change history / audit trails — walks the tier matrix (columns → audit log → temporal → event sourcing). Triggers on 'wer hat was wann', 'audit log'."
|
|
5
|
+
domain: engineering
|
|
6
|
+
workspaces:
|
|
7
|
+
- engineering
|
|
8
|
+
packs:
|
|
9
|
+
- history-discipline
|
|
10
|
+
trust:
|
|
11
|
+
level: professional
|
|
12
|
+
install:
|
|
13
|
+
default: false
|
|
14
|
+
removable: true
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# history-design
|
|
18
|
+
|
|
19
|
+
## When to use
|
|
20
|
+
|
|
21
|
+
- A model/table is declared audit-scoped ("we need to know who changed
|
|
22
|
+
what and when") and the mechanism must be chosen — NOT assumed.
|
|
23
|
+
- The user asks for an audit trail, change history, activity log, or
|
|
24
|
+
proposes event sourcing.
|
|
25
|
+
- NOT for reviewing an existing migration diff (route to
|
|
26
|
+
`schema-review`) and NOT for privacy/DSR policy design (route to
|
|
27
|
+
`privacy-review`; this skill only wires the interlock).
|
|
28
|
+
|
|
29
|
+
## Procedure
|
|
30
|
+
|
|
31
|
+
1. **Collect the requirement facts** (ask ONE question only if missing):
|
|
32
|
+
who edits the data (single editor vs multi-tenant), compliance need
|
|
33
|
+
(GDPR/SOC2/audit), point-in-time query need, replay/projection need,
|
|
34
|
+
expected mutation volume.
|
|
35
|
+
2. **Walk the tier matrix — normative, cheapest-sufficient wins:**
|
|
36
|
+
|
|
37
|
+
| Tier | Mechanism | Use when | Growth control |
|
|
38
|
+
|---|---|---|---|
|
|
39
|
+
| 0 | `updated_at`/`updated_by` columns | single-editor, no compliance need | none needed |
|
|
40
|
+
| 1 | Row-level audit log (Laravel: spatie/activitylog or owen-it/laravel-auditing; TS: thin custom audit table) | admin panels, SaaS tenant data, "wer hat was wann geändert" | retention policy REQUIRED | <!-- md-language-check: ignore -->
|
|
41
|
+
| 2 | DB temporal/system-versioned tables | point-in-time queries needed, DB supports it | partition rotation |
|
|
42
|
+
| 3 | Event sourcing | domain genuinely event-driven, replay/projection needed | snapshotting + archive REQUIRED |
|
|
43
|
+
|
|
44
|
+
**Default tier: 1.** Tier 3 requires an explicit architecture waiver
|
|
45
|
+
from the user — never "upgrade" to event sourcing unprompted.
|
|
46
|
+
3. **Apply the four interlocks to the chosen tier:**
|
|
47
|
+
- **Hygiene (R-B3):** audit storage indexed on
|
|
48
|
+
`(auditable_type, auditable_id, created_at)`; store JSON diffs, not
|
|
49
|
+
full-row copies, where a diff suffices.
|
|
50
|
+
- **Growth (R-A7):** the audit table itself declares retention (TTL,
|
|
51
|
+
pruning job, partition rotation, or archive path) — history must
|
|
52
|
+
not re-create the unbounded-growth problem it documents.
|
|
53
|
+
- **Privacy (R-B4):** audit records inherit the deletion/
|
|
54
|
+
anonymization obligations of the data they describe — a GDPR
|
|
55
|
+
Art. 17 path must exist before the mechanism ships.
|
|
56
|
+
- **Reliability (R-B5):** audit capture is same-transaction (Tier-1
|
|
57
|
+
default: observer + cheap single insert — allowed request-path
|
|
58
|
+
work) OR outbox/afterCommit with a durable queue when offloaded. A
|
|
59
|
+
lossy audit trail is worse than none.
|
|
60
|
+
4. **Emit the decision artifact** (Output below) and, when the tier
|
|
61
|
+
lands, hand implementation to the stack-native path (Laravel package
|
|
62
|
+
install + config, or the thin custom audit-table pattern for TS — no
|
|
63
|
+
dependency needed there).
|
|
64
|
+
|
|
65
|
+
## Output
|
|
66
|
+
|
|
67
|
+
The decision artifact MUST contain:
|
|
68
|
+
|
|
69
|
+
1. **Tier decision line** — `Tier N — <mechanism>` plus the one-sentence
|
|
70
|
+
cheapest-sufficient justification.
|
|
71
|
+
2. **Interlock checklist** — the four interlocks (hygiene, growth,
|
|
72
|
+
privacy, reliability) each with its concrete answer for this model,
|
|
73
|
+
not a bare checkmark.
|
|
74
|
+
3. **Rejected-tier note** — one line on the nearest rejected tier and
|
|
75
|
+
why (usually why NOT event sourcing, or why Tier 0 is insufficient).
|
|
76
|
+
|
|
77
|
+
## Gotcha
|
|
78
|
+
|
|
79
|
+
- Tier-1 reference per stack — Laravel: **spatie/laravel-activitylog**
|
|
80
|
+
(source-level comparison 2026-07-27: age-based `activitylog:clean`
|
|
81
|
+
retention command maps directly onto the R-A7 growth budget; JSON diff
|
|
82
|
+
columns match R-B3 hygiene) with **owen-it/laravel-auditing** as the
|
|
83
|
+
forensic alternative (ip/url/user-agent/tags; count-based pruning);
|
|
84
|
+
TS/Node: the thin custom audit-table pattern, no dependency. Re-verify
|
|
85
|
+
the package pick against the project's framework version at decision
|
|
86
|
+
time.
|
|
87
|
+
- Tier 2 (temporal tables) depends on the database: MariaDB/SQL Server
|
|
88
|
+
have system-versioned tables, vanilla MySQL and SQLite do not, and
|
|
89
|
+
Postgres needs an extension or trigger pattern — verify the actual
|
|
90
|
+
connector before recommending Tier 2.
|
|
91
|
+
|
|
92
|
+
## Do NOT
|
|
93
|
+
|
|
94
|
+
- Do NOT recommend event sourcing without an explicit architecture
|
|
95
|
+
waiver from the user — Tier 3 is an architecture, not an audit
|
|
96
|
+
mechanism.
|
|
97
|
+
- Do NOT ship any tier without its retention/growth answer — an
|
|
98
|
+
unbounded audit table is an F7 defect by definition.
|
|
99
|
+
- Do NOT copy full row snapshots into audit records when a diff
|
|
100
|
+
suffices — that is the denormalized-duplication failure (F4) applied
|
|
101
|
+
to history.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"skill": "history-design",
|
|
3
|
+
"last_eval": "2026-07-27",
|
|
4
|
+
"description": "5 should-trigger + 5 should-not-trigger. Should-trigger covers DE+EN phrasings for choosing an audit/history mechanism (tier matrix). Should-not-trigger covers near-miss neighbours: migration review (schema-review), privacy/DSR policy (privacy-review), retention floors (domain-safety-retention), git history.",
|
|
5
|
+
"queries": [
|
|
6
|
+
{ "q": "we need to track who changed what and when on tenant data", "trigger": true },
|
|
7
|
+
{ "q": "wir brauchen eine Änderungshistorie — wer hat was wann geändert?", "trigger": true },
|
|
8
|
+
{ "q": "should we use event sourcing for the orders domain?", "trigger": true },
|
|
9
|
+
{ "q": "add an audit trail to the admin panel models", "trigger": true },
|
|
10
|
+
{ "q": "which activity log package fits our Laravel app?", "trigger": true },
|
|
11
|
+
{ "q": "review this migration for missing indexes", "trigger": false },
|
|
12
|
+
{ "q": "how long may we keep support tickets under GDPR?", "trigger": false },
|
|
13
|
+
{ "q": "squash my last three git commits into one", "trigger": false },
|
|
14
|
+
{ "q": "anonymize user data on account deletion", "trigger": false },
|
|
15
|
+
{ "q": "profile the slow audit report query in production", "trigger": false }
|
|
16
|
+
]
|
|
17
|
+
}
|
|
@@ -67,9 +67,9 @@ human voice there; don't inject personality or restructure.
|
|
|
67
67
|
4. **Final rewrite** addressing the audit. Keep em/en dashes at or under
|
|
68
68
|
~2 per 500 words (density cap, not zero — house precedent CP1).
|
|
69
69
|
5. **Verify mechanically** when runtime available:
|
|
70
|
-
`npx tsx src/scripts/detect_ai_tells.ts --stdin --fail`
|
|
71
|
-
draft. No runtime → step-3 audit is the fallback (degrade,
|
|
72
|
-
skip audit).
|
|
70
|
+
`npx tsx node_modules/@event4u/agent-config/src/scripts/detect_ai_tells.ts --stdin --fail`
|
|
71
|
+
on final draft. No runtime → step-3 audit is the fallback (degrade,
|
|
72
|
+
don't skip audit).
|
|
73
73
|
6. **Deterministic self-check + factual-integrity guard.** Re-scan the
|
|
74
74
|
final draft against the [`anti-aiisms.md`](references/anti-aiisms.md)
|
|
75
75
|
self-validation thresholds (dash density, consecutive-staccato cap,
|
|
@@ -21,16 +21,17 @@ install:
|
|
|
21
21
|
|
|
22
22
|
> Read a character image, extract **every** feature (face marks, per-location
|
|
23
23
|
> tattoos incl. lettered text, exact hair split, per-eye colour, jewelry,
|
|
24
|
-
> asymmetry), diff against the character's canon so drift is caught
|
|
25
|
-
> ships. Output feeds [`image-creator`](../image-creator/SKILL.md)
|
|
26
|
-
> loop. Schema + rubric + loop: [`canon-spec.md`](canon-spec.md).
|
|
24
|
+
> asymmetry), and diff it against the character's canon so drift is caught
|
|
25
|
+
> **before** it ships. Output feeds [`image-creator`](../image-creator/SKILL.md)
|
|
26
|
+
> and the fidelity loop. Schema + rubric + loop: [`canon-spec.md`](canon-spec.md).
|
|
27
27
|
|
|
28
28
|
## When to use
|
|
29
29
|
|
|
30
30
|
- "Analyse this image / character", "does this match the canon", "check
|
|
31
31
|
character accuracy", "find what's wrong with this render".
|
|
32
|
-
-
|
|
33
|
-
-
|
|
32
|
+
- As the verify step of the fidelity loop (after `image-creator` generates).
|
|
33
|
+
- To bootstrap a Canon Spec from an authoritative portrait (the *image wins
|
|
34
|
+
over the text*).
|
|
34
35
|
|
|
35
36
|
NOT for: scene/motion review (→ `video-director`), non-character art
|
|
36
37
|
(→ `canvas-design`), cross-scene token locking (→ `character-consistency`,
|
|
@@ -39,7 +40,7 @@ which consumes this skill's output).
|
|
|
39
40
|
## Input
|
|
40
41
|
|
|
41
42
|
- Image **path or public URL** (per the `vision-analyze` shape).
|
|
42
|
-
- Optional: reference Canon Spec / character id (e.g.
|
|
43
|
+
- Optional: a reference Canon Spec / character id (e.g.
|
|
43
44
|
`agents/reference/ai-video/<project>/characters/<id>.json`) to diff against.
|
|
44
45
|
- **Input gate** (per the `image-ocr` contract): refuse blurry / sub-resolution
|
|
45
46
|
/ unreadable inputs with a clear reason rather than guessing.
|
|
@@ -64,16 +65,16 @@ which consumes this skill's output).
|
|
|
64
65
|
lives here, **never** written back onto the canon (Layer 1).
|
|
65
66
|
6. **If a reference is given — diff + score** per the rubric: per-feature
|
|
66
67
|
`match|partial|miss`, the **canon-breaking hard gate**, per-section scores,
|
|
67
|
-
advisory roll-up, `low`-confidence misses flagged `needs-better-image`
|
|
68
|
+
advisory roll-up, and `low`-confidence misses flagged `needs-better-image`
|
|
68
69
|
(not a hard fail). Emit concrete correction directives per miss.
|
|
69
70
|
|
|
70
71
|
## The one rule that overrides everything
|
|
71
72
|
|
|
72
|
-
**The image wins over the text.**
|
|
73
|
-
the canon text disagrees
|
|
74
|
-
against the canon
|
|
75
|
-
the image does not show (per `direct-answers` — no invented facts); mark
|
|
76
|
-
`unverifiable` instead.
|
|
73
|
+
**The image wins over the text.** When extracting from an authoritative portrait
|
|
74
|
+
and the canon text disagrees, record what is *visible*. When verifying a
|
|
75
|
+
candidate against the canon, the canon's `identity` is the truth. Never invent a
|
|
76
|
+
feature the image does not show (per `direct-answers` — no invented facts); mark
|
|
77
|
+
it `unverifiable` instead.
|
|
77
78
|
|
|
78
79
|
## Output format
|
|
79
80
|
|
|
@@ -119,3 +120,4 @@ agent's, in-session.
|
|
|
119
120
|
- [`image-creator`](../image-creator/SKILL.md) — consumes the diff; the loop partner.
|
|
120
121
|
- [`character-consistency`](../character-consistency/SKILL.md) — consumes the load-bearing token subset of the `identity` layer.
|
|
121
122
|
- [`canon-spec.md`](canon-spec.md) — schema, rubric, fidelity loop.
|
|
123
|
+
- [`screenshot-hygiene`](../screenshot-hygiene/SKILL.md) — reuses this skill's OCR text-read to detect sensitive data in a documentation screenshot before it ships.
|
|
@@ -45,7 +45,7 @@ with governance applied before delivery. All adapters are scaffold-tier (dry-run
|
|
|
45
45
|
write the edit prompt in the target provider's grammar. For inpaint, describe what
|
|
46
46
|
fills the masked region. For variation, carry the original seed/ref-image path forward.
|
|
47
47
|
5. **Invoke the adapter (dry-run today)** — run
|
|
48
|
-
`src/scripts/ai-image/adapters/<provider>.sh` with the assembled params including
|
|
48
|
+
`node_modules/@event4u/agent-config/src/scripts/ai-image/adapters/<provider>.sh` with the assembled params including
|
|
49
49
|
the source image path and, for inpaint, the mask path. Validate the returned
|
|
50
50
|
artifact path or dry-run confirmation. All adapters are `experimental`
|
|
51
51
|
(scaffold-tier); no live editing occurs until a maintainer promotes the adapter
|
|
@@ -98,3 +98,4 @@ with governance applied before delivery. All adapters are scaffold-tier (dry-run
|
|
|
98
98
|
- [`image-provider-routing`](../image-provider-routing/SKILL.md) — select the right provider before writing the prompt.
|
|
99
99
|
- [`prompt-engineering-image`](../prompt-engineering-image/SKILL.md) — translate the edit brief into provider-specific prompt grammar.
|
|
100
100
|
- [`image-likeness-and-rights`](../../rules/image-likeness-and-rights.md) — rights check before editing real-person likenesses or brand marks.
|
|
101
|
+
- [`screenshot-hygiene`](../screenshot-hygiene/SKILL.md) — for redacting a documentation screenshot, use a deterministic opaque box/blur (never the lossy inpaint here).
|
|
@@ -41,7 +41,8 @@ governance. All adapters are scaffold-tier (dry-run) until promoted to `stable`.
|
|
|
41
41
|
4. **Reuse ref-image / seed for consistency** — if the brief is part of a series, carry
|
|
42
42
|
the seed value or ref-image path forward. Seed reuse is the primary consistency lever;
|
|
43
43
|
re-describing the subject each time is not.
|
|
44
|
-
5. **Invoke the adapter (dry-run today)** — run
|
|
44
|
+
5. **Invoke the adapter (dry-run today)** — run
|
|
45
|
+
`node_modules/@event4u/agent-config/src/scripts/ai-image/adapters/<provider>.sh`
|
|
45
46
|
with the assembled params. Validate the returned artifact path or dry-run confirmation.
|
|
46
47
|
All adapters are `experimental` (scaffold-tier); no live generation occurs until a
|
|
47
48
|
maintainer promotes the adapter via `provider-lifecycle-discipline`.
|
|
@@ -25,7 +25,7 @@ promotion per `provider-lifecycle-discipline`.
|
|
|
25
25
|
## When to use
|
|
26
26
|
|
|
27
27
|
- Choosing which image model fits a brief (logo, banner, photo, icon, general art).
|
|
28
|
-
- Before calling any `src/scripts/ai-image/adapters/*.sh` adapter.
|
|
28
|
+
- Before calling any `node_modules/@event4u/agent-config/src/scripts/ai-image/adapters/*.sh` adapter.
|
|
29
29
|
- When the user asks "which image model should I use?" or "route this image job."
|
|
30
30
|
|
|
31
31
|
## Provider decision table
|
|
@@ -92,5 +92,5 @@ photoreal jobs go to Flux.
|
|
|
92
92
|
|
|
93
93
|
- [`prompt-engineering-image`](../prompt-engineering-image/SKILL.md) — translate the brief into provider-specific prompt grammar.
|
|
94
94
|
- [`provider-lifecycle-discipline`](../../rules/provider-lifecycle-discipline.md) — read lifecycle tier before any run.
|
|
95
|
-
- `src/scripts/ai-image/adapters/` — the four adapter files and their header comments.
|
|
95
|
+
- `node_modules/@event4u/agent-config/src/scripts/ai-image/adapters/` — the four adapter files and their header comments.
|
|
96
96
|
- [`media-governance-routing`](../../rules/media-governance-routing.md) — rights / likeness policies before generation.
|
|
@@ -89,7 +89,7 @@ report per [`docs/contracts/prelaunch-diagnostics.md`](../../../docs/contracts/p
|
|
|
89
89
|
- **Questions section** — list the questions that would change the
|
|
90
90
|
diagnosis; the next run converts them into evidence or findings.
|
|
91
91
|
- Validate + verdict via
|
|
92
|
-
|
|
92
|
+
`npx tsx node_modules/@event4u/agent-config/src/scripts/prelaunch_diagnostics.ts validate <report.json>`;
|
|
93
93
|
regression-gate against the committed baseline via
|
|
94
94
|
`… diff <baseline> <current> --ci` (contract § 4–6).
|
|
95
95
|
|
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
---
|
|
2
|
+
model_tier: medium
|
|
3
|
+
name: license-compliance-audit
|
|
4
|
+
description: "Run the offline (jscpd) and online (scanoss-py) similarity scanners on demand against a diff or path — the ONLY home of this repo's detection capability; no CI gate exists or ever ran it automatically"
|
|
5
|
+
domain: engineering
|
|
6
|
+
workspaces:
|
|
7
|
+
- engineering
|
|
8
|
+
packs:
|
|
9
|
+
- engineering-base
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# license-compliance-audit
|
|
13
|
+
|
|
14
|
+
Gate G0 (`road-to-provenance-and-license-governance`, Phase 0) measured both
|
|
15
|
+
candidate similarity detectors against a frozen golden corpus and neither
|
|
16
|
+
met the pre-registered bar for a CI gate. Council resolved (2026-07-28,
|
|
17
|
+
Option A): **no `lint_code_provenance.ts` in any form — not even
|
|
18
|
+
advisory.** This skill is the result: the scan capability that used to be a
|
|
19
|
+
planned CI gate now exists only as something a human invokes deliberately,
|
|
20
|
+
so every hit gets investigated *because* a human asked for it — never as a
|
|
21
|
+
silent pipeline signal nobody reads.
|
|
22
|
+
|
|
23
|
+
## When to use
|
|
24
|
+
|
|
25
|
+
- Before merging a diff that looks suspiciously similar to something you've
|
|
26
|
+
seen elsewhere, or that a reviewer flagged.
|
|
27
|
+
- During a periodic self-audit (e.g. the Phase-4 "run the full pipeline on
|
|
28
|
+
this repo" dogfood exercise).
|
|
29
|
+
- A reviewer or the `origin: uncertain` self-flag from
|
|
30
|
+
[`code-provenance`](../../rules/code-provenance.md) names a residual-class
|
|
31
|
+
file worth a closer look.
|
|
32
|
+
|
|
33
|
+
Do NOT use when:
|
|
34
|
+
|
|
35
|
+
- You expect this to run automatically in CI — it does not, by explicit
|
|
36
|
+
council decision; nothing here is wired into any pipeline.
|
|
37
|
+
- You expect a clean result to prove the code was not copied — it cannot;
|
|
38
|
+
see the scope bound below.
|
|
39
|
+
- You already have a specific, known source to check against a specific
|
|
40
|
+
license — that's [`license-compliance-borrow-check`](../license-compliance-borrow-check/SKILL.md),
|
|
41
|
+
a targeted one-source check, not a corpus-wide scan.
|
|
42
|
+
|
|
43
|
+
## Procedure
|
|
44
|
+
|
|
45
|
+
1. **Inspect available tooling.** The offline layer (L-1) is always
|
|
46
|
+
available via `npx`:
|
|
47
|
+
```bash
|
|
48
|
+
npx jscpd --version
|
|
49
|
+
```
|
|
50
|
+
The online layer (L0) is optional — check whether it's installed and
|
|
51
|
+
reachable:
|
|
52
|
+
```bash
|
|
53
|
+
scanoss-py --version # or: pip show scanoss
|
|
54
|
+
```
|
|
55
|
+
Offline-only is expected and fine in most environments — report it
|
|
56
|
+
honestly, not as a failure.
|
|
57
|
+
2. **Run the offline scan (L-1)** against the target path or diff:
|
|
58
|
+
```bash
|
|
59
|
+
npx jscpd <path> --min-tokens 25
|
|
60
|
+
```
|
|
61
|
+
`--min-tokens 25` is the pre-registered shipping value — the best
|
|
62
|
+
false-positive-clean point of the S0.3 sweep
|
|
63
|
+
(`internal/bench/provenance/reports/baseline-2026-07-28.md`). Read every
|
|
64
|
+
reported clone pair as a **candidate**, never a verdict.
|
|
65
|
+
3. **If L0 is reachable, run the fingerprint scan:**
|
|
66
|
+
```bash
|
|
67
|
+
scanoss-py scan <path>
|
|
68
|
+
```
|
|
69
|
+
Only WFP fingerprints leave the machine, never raw source (privacy by
|
|
70
|
+
construction, principle 7). If L0 is unreachable, rate-limited, or not
|
|
71
|
+
installed, report the result as `partial (offline)` explicitly — never
|
|
72
|
+
claim a full two-layer scan ran.
|
|
73
|
+
4. **Investigate every hit manually.** For each match: is the matched file
|
|
74
|
+
already in `provenance/borrows.jsonl` (cleared)? Does it read like
|
|
75
|
+
independent convergence on a common algorithm shape, or an unattributed
|
|
76
|
+
real copy? Open both files side by side before deciding — a match id is
|
|
77
|
+
a starting point, not a conclusion.
|
|
78
|
+
5. **Route unresolved hits.** A hit with no existing ledger entry and no
|
|
79
|
+
independent-convergence explanation routes to
|
|
80
|
+
[`license-compliance-borrow-check`](../license-compliance-borrow-check/SKILL.md)
|
|
81
|
+
to classify and draft the entry. Never clear a hit yourself by simply
|
|
82
|
+
deciding it's fine.
|
|
83
|
+
6. **Report the scope bound alongside every result** (see below) — a clean
|
|
84
|
+
run means "nothing matched this KB/corpus at this sensitivity", never
|
|
85
|
+
"no copying happened".
|
|
86
|
+
|
|
87
|
+
## What the measured numbers mean — and don't
|
|
88
|
+
|
|
89
|
+
On the frozen synthetic corpus (`internal/bench/provenance/`, 36 files,
|
|
90
|
+
content-sha256 `dbbc84a7…34bb3`):
|
|
91
|
+
|
|
92
|
+
| layer | verbatim+rename recall | rename-only recall | false positives |
|
|
93
|
+
|---|---:|---:|---:|
|
|
94
|
+
| L-1 jscpd `--min-tokens 25` | 10/16 | 4/8 | 0/12 |
|
|
95
|
+
| L0 scanoss | 4/16 | 0/8 | 2/12 |
|
|
96
|
+
| **union (both layers)** | **12/16** | **4/8** | **2/12** |
|
|
97
|
+
|
|
98
|
+
Full source: `internal/bench/provenance/reports/baseline-2026-07-28.md`.
|
|
99
|
+
|
|
100
|
+
- **Scope bound:** the corpus is `synthetic-canonical` — independently
|
|
101
|
+
authored implementations of well-known algorithm shapes, never fetched or
|
|
102
|
+
pasted from any upstream file. This measures **transformation-depth
|
|
103
|
+
sensitivity and false-positive rate on independent code** — it does
|
|
104
|
+
**not** measure recall against SCANOSS's real-OSS knowledge base. No
|
|
105
|
+
sample here is indexed anywhere, so a KB lookup returning zero hits says
|
|
106
|
+
nothing about the detector's real-world recall. Real-KB recall is
|
|
107
|
+
unmeasured and would need a second, real-snippet corpus.
|
|
108
|
+
- **Rename-only laundering is not reliably caught** — 0/8 (SCANOSS), 4/8
|
|
109
|
+
(jscpd). The provenance ledger, not this scan, is the anti-launder
|
|
110
|
+
control (see [`code-provenance`](../../rules/code-provenance.md)).
|
|
111
|
+
- **No tool sees model training data.** Unconscious reproduction from
|
|
112
|
+
training data is not addressed by this scan at all, regardless of
|
|
113
|
+
outcome.
|
|
114
|
+
|
|
115
|
+
## Output format
|
|
116
|
+
|
|
117
|
+
1. Per scan target: which layer(s) actually ran, hit or clean, and — if
|
|
118
|
+
the online layer was unreachable — the explicit `partial (offline)`
|
|
119
|
+
marker (never a silent green presented as a full scan).
|
|
120
|
+
2. For every hit: the matched file/snippet, a manual same-shape-vs-real-copy
|
|
121
|
+
judgment, and the routing decision (already ledgered / route to
|
|
122
|
+
`license-compliance-borrow-check` / independent convergence, no action).
|
|
123
|
+
3. The scope-bound paragraph from the section above, restated so the
|
|
124
|
+
requester never reads a clean result as a copying guarantee.
|
|
125
|
+
|
|
126
|
+
## Gotcha
|
|
127
|
+
|
|
128
|
+
- **A clean scan is not proof of originality.** It means "nothing matched
|
|
129
|
+
at this sensitivity, in this corpus/KB" — never "not copied from
|
|
130
|
+
training data".
|
|
131
|
+
- **Rename-only copies routinely pass both layers.** Do not trust a clean
|
|
132
|
+
re-scan after a purely cosmetic rewrite as evidence of real
|
|
133
|
+
transformation.
|
|
134
|
+
- **Both of SCANOSS's measured false positives came from independently
|
|
135
|
+
authored files** matching on convergent canonical-algorithm shape (MIT
|
|
136
|
+
snippet matches) — a hit is an investigation trigger, not an accusation.
|
|
137
|
+
- **Nothing here is wired into CI.** A hit found by this skill never
|
|
138
|
+
blocked anything automatically; if you expected a pipeline signal, there
|
|
139
|
+
isn't one — that's the point of Gate G0's Option A resolution.
|
|
140
|
+
|
|
141
|
+
## Do NOT
|
|
142
|
+
|
|
143
|
+
- NEVER claim or imply this scan runs in CI — it explicitly does not, by
|
|
144
|
+
council decision (Gate G0, Option A).
|
|
145
|
+
- NEVER report a scan as complete when the online layer was unreachable —
|
|
146
|
+
always say `partial (offline)`.
|
|
147
|
+
- NEVER present a clean result as "provably not copied" — restate the
|
|
148
|
+
scope bound every time a result is shared.
|
|
149
|
+
- NEVER clear a hit without either a ledger entry or a documented
|
|
150
|
+
independent-convergence judgment.
|
|
151
|
+
|
|
152
|
+
## See also
|
|
153
|
+
|
|
154
|
+
- [`code-provenance`](../../rules/code-provenance.md) — the rule that makes
|
|
155
|
+
the ledger, not this scan, the primary anti-launder control.
|
|
156
|
+
- [`license-compliance-borrow-check`](../license-compliance-borrow-check/SKILL.md) —
|
|
157
|
+
where an unresolved hit routes for classification + ledger drafting.
|
|
158
|
+
- `internal/bench/provenance/reports/baseline-2026-07-28.md` — the full
|
|
159
|
+
measured baseline this skill's numbers are drawn from.
|
|
160
|
+
- `docs/CLAIMS.md` — claim `provenance-detector-transformation-sensitivity`
|
|
161
|
+
(unbacked, carries the same scope bound).
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
{
|
|
2
|
+
"skill": "license-compliance-audit",
|
|
3
|
+
"last_eval": "2026-07-28",
|
|
4
|
+
"description": "5 should-trigger + 5 should-not-trigger queries. Should-trigger covers running the on-demand jscpd/scanoss similarity scan on a diff or path, and asking whether a diff looks copied from known OSS. Should-not-trigger covers near-miss neighbours (a single named-source license check, notices regeneration, generic code review, dependency vetting) whose vocabulary overlaps.",
|
|
5
|
+
"queries": [
|
|
6
|
+
{
|
|
7
|
+
"q": "this diff looks suspiciously similar to something I've seen, run a similarity scan against known OSS",
|
|
8
|
+
"trigger": true
|
|
9
|
+
},
|
|
10
|
+
{
|
|
11
|
+
"q": "run jscpd and scanoss on this PR to check for copied code",
|
|
12
|
+
"trigger": true
|
|
13
|
+
},
|
|
14
|
+
{
|
|
15
|
+
"q": "do a self-audit of the whole repo for potential license violations",
|
|
16
|
+
"trigger": true
|
|
17
|
+
},
|
|
18
|
+
{
|
|
19
|
+
"q": "check whether this file matches anything in the SCANOSS knowledge base",
|
|
20
|
+
"trigger": true
|
|
21
|
+
},
|
|
22
|
+
{
|
|
23
|
+
"q": "the reviewer flagged this function as possibly lifted from elsewhere, scan for a match",
|
|
24
|
+
"trigger": true
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"q": "I want to borrow this specific function from https://github.com/example/repo, check its license",
|
|
28
|
+
"trigger": false,
|
|
29
|
+
"note": "single named source, targeted license check → license-compliance-borrow-check"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"q": "regenerate the third-party notices file from the ledger",
|
|
33
|
+
"trigger": false,
|
|
34
|
+
"note": "notices regeneration → license-compliance-credits"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"q": "review this diff for null-safety and edge cases",
|
|
38
|
+
"trigger": false,
|
|
39
|
+
"note": "correctness review, not a similarity scan"
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"q": "is this new npm package real or a hallucinated name?",
|
|
43
|
+
"trigger": false,
|
|
44
|
+
"note": "dependency existence check → supply-chain-intake"
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
"q": "set up a CI job that blocks merges on copied code",
|
|
48
|
+
"trigger": false,
|
|
49
|
+
"note": "no CI gate exists or is planned here — Gate G0 cancelled it; this skill is on-demand only"
|
|
50
|
+
}
|
|
51
|
+
]
|
|
52
|
+
}
|