@event4u/agent-config 3.0.0 → 3.1.0

package/.agent-src/templates/hooks/pre-commit-roadmap-progress

@@ -1,60 +1,99 @@
 #!/usr/bin/env bash
-# Pre-commit hook: roadmap progress dashboard sync (event4u/agent-config)
+# Pre-commit hook: roadmap progress + artefact frontmatter
+# (event4u/agent-config — installed by `./agent-config hooks:install`).
 #
-# Installed by `./agent-config hooks:install`. Aborts the commit if
-# `agents/roadmaps-progress.md` is out of date relative to staged
-# changes under `agents/roadmaps/`. Exits silently when no roadmap
-# files are staged — zero overhead on unrelated commits.
+# Two opt-in checks run on relevant staged paths and short-circuit
+# otherwise:
+#   1. agents/roadmaps-progress.md sync (against agents/roadmaps/*.md)
+#   2. ADR-013 per-artefact frontmatter contract (.agent-src.uncompressed/*.md)
 #
 # To run manually:
 #   ./agent-config roadmap:progress-check
+#   python3 scripts/lint_artefact_frontmatter.py
 #
 # To uninstall:
 #   rm .git/hooks/pre-commit
 set -e
 
-# Only act on commits that touch roadmap content.
 staged="$(git diff --cached --name-only --diff-filter=ACMR 2>/dev/null || true)"
+
+roadmap_relevant=false
+frontmatter_relevant=false
 case "$staged" in
   *agents/roadmaps/*.md*|*agents/roadmaps-progress.md*|*.augment/scripts/update_roadmap_progress.py*)
-    : ;;
-  *)
-    exit 0 ;;
+    roadmap_relevant=true ;;
+esac
+case "$staged" in
+  *.agent-src.uncompressed/*.md*|*config/discovery/*.yml*|*scripts/lint_artefact_frontmatter.py*)
+    frontmatter_relevant=true ;;
 esac
 
-# Resolve the script — prefer the consumer-shipped path, fall back to
-# the source-of-truth copy when run from inside the package itself.
-script=""
-for cand in \
-  ".augment/scripts/update_roadmap_progress.py" \
-  ".agent-src/scripts/update_roadmap_progress.py" \
-  ".agent-src.uncompressed/scripts/update_roadmap_progress.py"; do
-  if [ -f "$cand" ]; then
-    script="$cand"
-    break
-  fi
-done
-
-if [ -z "$script" ]; then
-  echo "⚠️  pre-commit-roadmap-progress: update_roadmap_progress.py not found." >&2
-  echo "    Run \`task install\` (or \`./agent-config install\`) and retry." >&2
-  echo "    Skipping check — letting commit through." >&2
+if ! $roadmap_relevant && ! $frontmatter_relevant; then
   exit 0
 fi
 
-if ! python3 "$script" --check >/dev/null 2>&1; then
-  echo "❌  agents/roadmaps-progress.md is stale relative to your staged changes." >&2
-  echo "" >&2
-  echo "    Regenerate the dashboard with one of:" >&2
-  echo "      ./agent-config roadmap:progress" >&2
-  echo "      task roadmap-progress" >&2
-  echo "      python3 $script" >&2
-  echo "" >&2
-  echo "    Then \`git add agents/roadmaps-progress.md\` and retry the commit." >&2
-  echo "" >&2
-  echo "    To bypass once (NOT recommended):" >&2
-  echo "      git commit --no-verify" >&2
-  exit 1
+resolve() {
+  local cand
+  for cand in "$@"; do
+    if [ -f "$cand" ]; then
+      printf '%s\n' "$cand"
+      return 0
+    fi
+  done
+  return 1
+}
+
+# --- Check 1: roadmap progress dashboard sync --------------------------
+if $roadmap_relevant; then
+  rp_script="$(resolve \
+    ".augment/scripts/update_roadmap_progress.py" \
+    ".agent-src/scripts/update_roadmap_progress.py" \
+    ".agent-src.uncompressed/scripts/update_roadmap_progress.py" || true)"
+
+  if [ -z "$rp_script" ]; then
+    echo "⚠️  pre-commit: update_roadmap_progress.py not found — skipping roadmap check." >&2
+  elif ! python3 "$rp_script" --check >/dev/null 2>&1; then
+    echo "❌  agents/roadmaps-progress.md is stale relative to your staged changes." >&2
+    echo "" >&2
+    echo "    Regenerate the dashboard with one of:" >&2
+    echo "      ./agent-config roadmap:progress" >&2
+    echo "      task roadmap-progress" >&2
+    echo "      python3 $rp_script" >&2
+    echo "" >&2
+    echo "    Then \`git add agents/roadmaps-progress.md\` and retry the commit." >&2
+    echo "" >&2
+    echo "    To bypass once (NOT recommended):" >&2
+    echo "      git commit --no-verify" >&2
+    exit 1
+  fi
+fi
+
+# --- Check 2: ADR-013 artefact frontmatter contract --------------------
+if $frontmatter_relevant; then
+  fm_script="$(resolve \
+    ".augment/scripts/lint_artefact_frontmatter.py" \
+    ".agent-src/scripts/lint_artefact_frontmatter.py" \
+    "scripts/lint_artefact_frontmatter.py" || true)"
+
+  if [ -z "$fm_script" ]; then
+    echo "⚠️  pre-commit: lint_artefact_frontmatter.py not found — skipping frontmatter check." >&2
+  elif ! python3 "$fm_script" --quiet >/dev/null 2>&1; then
+    echo "❌  Artefact frontmatter lint failed (ADR-013 contract violation)." >&2
+    echo "" >&2
+    echo "    Re-run for details:" >&2
+    echo "      python3 $fm_script" >&2
+    echo "      task lint-artefact-frontmatter" >&2
+    echo "" >&2
+    echo "    Common fixes:" >&2
+    echo "      • Add missing workspaces/packs/lifecycle/trust/install keys." >&2
+    echo "      • Pick values from config/discovery/{workspaces,packs}.yml." >&2
+    echo "      • For scaffolds, add the path to" >&2
+    echo "        config/discovery/unassigned-artefacts.yml with a reason." >&2
+    echo "" >&2
+    echo "    To bypass once (NOT recommended):" >&2
+    echo "      git commit --no-verify" >&2
+    exit 1
+  fi
 fi
 
 exit 0

package/.agent-src/templates/scripts/work_engine/_lib/agent_settings.py

@@ -99,11 +99,14 @@ ANCHOR_GIT = "git"
 
 #: Marker subpaths that qualify a bare ``agents/`` directory as a project
 #: anchor (D1). Any one is sufficient. Bare ``agents/`` without a marker
-#: is **not** an anchor.
+#: is **not** an anchor. ``.event4u-bridge.yml`` is the global-only
+#: consumer anchor (ADR-020 § Phase 4.2) — a clean consumer repo only
+#: ever ships ``agents/overrides/`` plus this marker.
 _AGENTS_DIR_MARKERS: tuple[str, ...] = (
     "roadmaps",
     "settings/.ai-council.yml",
     "roadmaps-progress.md",
+    ".event4u-bridge.yml",
 )
 
 #: Kill-switch (D5). When set to ``"1"``, :func:`find_project_root` and

package/.agent-src/templates/scripts/work_engine/orchestration.py

@@ -57,21 +57,35 @@ class PipelineState:
 def _load_pipeline(path: Path) -> dict[str, Any]:
     """Reuse the linter's loader so the runtime accepts the same shape.
 
-    Walks parents to find a directory containing ``scripts/hooks/``
-    so the loader is reachable both when this module runs from the
-    consumer projection (``.agent-src/templates/scripts/work_engine/``)
-    and from the source-of-truth tree
-    (``.agent-src.uncompressed/templates/scripts/work_engine/``).
+    Walks parents to find ``scripts/hooks/dispatch_hook.py`` so the
+    loader is reachable both when this module runs from the consumer
+    projection (``.agent-src/templates/scripts/work_engine/``) and
+    from the source-of-truth tree
+    (``packages/<pack>/.agent-src.uncompressed/templates/scripts/work_engine/``).
+    Loaded via ``importlib.util`` by file path to avoid namespace
+    collisions with test packages named ``hooks``.
     """
-    import sys
+    import importlib.util
     here = Path(__file__).resolve()
+    candidate: Path | None = None
     for parent in here.parents:
-        candidate = parent / "scripts" / "hooks" / "dispatch_hook.py"
-        if candidate.is_file():
-            sys.path.insert(0, str(parent / "scripts"))
+        probe = parent / "scripts" / "hooks" / "dispatch_hook.py"
+        if probe.is_file():
+            candidate = probe
             break
-    from hooks.dispatch_hook import _load_yaml  # noqa: E402
-    doc = _load_yaml(path)
+    if candidate is None:
+        raise RuntimeError(
+            "could not locate scripts/hooks/dispatch_hook.py from "
+            f"{here}"
+        )
+    spec = importlib.util.spec_from_file_location(
+        "_work_engine_dispatch_hook", candidate
+    )
+    if spec is None or spec.loader is None:
+        raise RuntimeError(f"cannot load spec for {candidate}")
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+    doc = module._load_yaml(path)
     if not isinstance(doc, dict):
         raise ValueError(f"{path}: top-level must be a mapping")
     return doc

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Shared agent configuration \u2014 skills for AI coding tools (Claude Code, Augment, Cursor, Cline, Windsurf, Gemini CLI).",
-    "version": "3.0.0",
+    "version": "3.1.0",
     "keywords": [
       "agent-config",
       "skills",
@@ -186,6 +186,7 @@
         "./.claude/skills/hiring-loop-design",
         "./.claude/skills/implement-ticket",
         "./.claude/skills/incident-commander",
+        "./.claude/skills/install-via-agent",
         "./.claude/skills/jira-integration",
         "./.claude/skills/jira-ticket",
         "./.claude/skills/jobs-events",

package/AGENTS.md

@@ -4,7 +4,7 @@
 
 ## Source of truth
 
-Edit `.agent-src.uncompressed/` only. Generated trees (`.agent-src/`, `.augment/`, `.claude/`, `.cursor/`, `.clinerules/`, `.windsurfrules`) regenerate from `task sync` + `task generate-tools`; never hand-edit.
+Edit `packages/<pack>/.agent-src.uncompressed/` only. Generated trees (`.agent-src/`, `.augment/`, `.claude/`, `.cursor/`, `.clinerules/`, `.windsurfrules`) regenerate from `task sync` + `task generate-tools`; never hand-edit.
 
 ## Working on this repo
 
@@ -12,24 +12,26 @@ Edit `.agent-src.uncompressed/` only. Generated trees (`.agent-src/`, `.augment/
 task sync              # regenerate .agent-src/, .augment/
 task generate-tools    # regenerate .claude/, .cursor/, .clinerules/, .windsurfrules
 task ci                # full pipeline — green before PR
+# maintainer: AGENT_CONFIG_DEV_MODE=1 opens --scope=project (docs/maintainers/dev-mode.md)
 ```
 
 ## Pointers
 
-- **Package self-orientation** (beta) — identity, four-wing cognition map, repo layout, tech stack, key-rules table, telemetry, command-suggester: [`docs/contracts/package-self-orientation.md`](docs/contracts/package-self-orientation.md).
-- **Kernel + Router** (beta) — 9 always-loaded Iron-Law rules, tier-1 / tier-2 routing, cost profiles, per-rule char caps enforced by `task lint-rule-budget`: [`kernel-membership`](docs/contracts/kernel-membership.md) + [`rule-router`](docs/contracts/rule-router.md).
+- **Package self-orientation** — identity, cognition map, layout, stack, key rules, telemetry: [`package-self-orientation`](docs/contracts/package-self-orientation.md).
+- **Kernel + Router** — 9 Iron-Law rules, tier-1/2 routing, cost profiles, per-rule caps: [`kernel-membership`](docs/contracts/kernel-membership.md) + [`rule-router`](docs/contracts/rule-router.md).
+- **Trust & Safety** — trust-level enum, HRR banner, safety floors, installer confirm: [`trust-and-safety`](docs/contracts/trust-and-safety.md) + [`ADR-018`](docs/decisions/ADR-018-trust-and-safety-layer.md).
 - **Content pipelines** — A→D source / Augment / multi-tool / Claude.ai-bundle projections, indexed at [`docs/architecture.md`](docs/architecture.md); sub-pipelines under [`docs/architecture/`](docs/architecture/).
-- **Editing this repo** — Iron-Law rules (edit-discipline, source-of-truth, skill-quality) + Thin-Root contract govern every change here: [`augment-source-of-truth`](.agent-src/rules/augment-source-of-truth.md) + [`agents-md-thin-root`](.agent-src/skills/agents-md-thin-root/SKILL.md).
+- **Editing this repo** — Iron-Law rules + Thin-Root contract govern every change: [`augment-source-of-truth`](.agent-src/rules/augment-source-of-truth.md) + [`agents-md-thin-root`](.agent-src/skills/agents-md-thin-root/SKILL.md).
 - **Consumer story** — `npx` + `scripts/install.sh` opt-in flags, sandbox / offline install paths, verified-offline manifest: [`README.md`](README.md).
-- **Personas** — 11 review-lens cast (6 core · 5 specialist), `personas:` vs `/mode` axes, override pattern: [`docs/personas.md`](docs/personas.md) (beta).
-- **Discovery** (workspaces / packs / `dist/discovery/discovery-manifest.json`) — contract [`ADR-013`](docs/decisions/ADR-013-discovery-frontmatter-contract.md), how-to [`customization § Workspaces & packs`](docs/customization.md#workspaces--packs-discovery).
+- **Personas** — 11 review-lens cast (6 core · 5 specialist), `personas:` vs `/mode`: [`docs/personas.md`](docs/personas.md).
+- **Discovery** — workspaces / packs / dist manifest; contract [`ADR-013`](docs/decisions/ADR-013-discovery-frontmatter-contract.md), how-to [`customization § Workspaces & packs`](docs/customization.md#workspaces--packs-discovery).
 
 ## Emergency triage — read this when nothing else is reachable
 
 1. **What is this repo?** — `event4u/agent-config`, a governed skill / rule / command suite for AI coding tools (no application runtime).
 2. **What language?** — All `.md` content is English; agents mirror the user's language at runtime.
-3. **Where do I edit?** — `.agent-src.uncompressed/` only. Never the generated trees.
+3. **Where do I edit?** — `packages/<pack>/.agent-src.uncompressed/` only. Never the generated trees.
 4. **Lint / test / sync entry point?** — `task ci` (full pipeline). Subsets: `task sync`, `task generate-tools`, `task lint-skills`, `task test`.
-5. **Where do the always-active rules live?** — `.agent-src/rules/` (kernel = 9 Iron-Law rules; tier-1 / tier-2 routed via `.agent-src/router.json`).
+5. **Where do the always-active rules live?** — `.agent-src/rules/` (kernel = 9 Iron-Law rules; tier-1 / tier-2 routed via `dist/router.json`).