@ainova-systems/intelligence 0.19.0 → 0.21.0

package/engine/adapters/codex.sh

@@ -6,6 +6,13 @@
 # inlines always-on rules into AGENTS.md, so this adapter only emits skills
 # and subagent definitions.
 #
+# Rules: an always-on rule AGENTS.md does not carry — a local one, or one whose
+#   targets leave `agents` out — goes into AGENTS.override.md beside it
+#   (decision 0021). Codex reads that file instead of AGENTS.md in the same
+#   directory, so it holds the whole AGENTS.md plus those rules. The contract
+#   ignores it, and it exists only while such a rule does; one Intelligence did
+#   not generate is never touched, and refuses a render that needs the path.
+#
 # Skills: copy skill directories in full to .agents/skills/{name}/ (Codex
 #   reads from $REPO_ROOT/.agents/skills exclusively per official docs)
 # Agents: -> .codex/agents/{name}.toml (name, description, model,
@@ -16,7 +23,9 @@
 # Every per-file loop batches its work into one awk process (see the batched
 # helpers in lib/common.sh): process spawns dominate sync time on Windows.
 
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/common.sh"
+# The engine and the CLI load the shared library before any adapter. Only a
+# standalone source of this file loads it here: that costs a dirname process.
+declare -F finalize_output_file >/dev/null 2>&1 || source "$(dirname "${BASH_SOURCE[0]}")/../lib/common.sh"
 
 adapter_contract_codex() {
     local output="${1%/}"
@@ -24,8 +33,61 @@ adapter_contract_codex() {
     adapter_contract_requires agents
     adapter_contract_managed ".agents/skills"
     adapter_contract_owned "$output/agents"
+    # Marker-managed: a hand-written override is left alone.
+    adapter_contract_managed "AGENTS.override.md"
     adapter_contract_ignore ".agents/skills/"
     adapter_contract_ignore "$output/agents/"
+    adapter_contract_ignore "AGENTS.override.md"
+}
+
+CODEX_OVERRIDE_MARKER="<!-- Generated by intelligence-sync. Do not edit manually. -->"
+
+# sync_codex_override <repo_root> <config_file> — write AGENTS.override.md
+# while an always-on rule AGENTS.md does not carry is for Codex, and remove a
+# generated one otherwise.
+sync_codex_override() {
+    local repo_root="$1" config_file="$2" override="$1/AGENTS.override.md" first="" agents_file i
+    local -a files=() names=()
+    source_artifacts_var "$repo_root" "$config_file" rules codex "AGENTS.override.md"
+    for ((i = 0; i < ${#IS_SOURCE_FILES[@]}; i++)); do
+        [ "${IS_SOURCE_SCOPED[i]}" = 0 ] && [ "${IS_SOURCE_IN_AGENTS[i]}" = 0 ] || continue
+        files+=("${IS_SOURCE_FILES[i]}")
+        names+=("${IS_SOURCE_NAMES[i]}")
+    done
+    if [ -f "$override" ]; then
+        IFS= read -r first < "$override" || true
+        if [ "${first%$'\r'}" != "$CODEX_OVERRIDE_MARKER" ]; then
+            [ "${#files[@]}" -gt 0 ] || return 0
+            echo "ERROR: AGENTS.override.md was not generated by intelligence-sync, but ${names[*]} need it: always-on rules for Codex that AGENTS.md does not carry go there. Move its guidance into a rule, remove it, then sync." >&2
+            return 1
+        fi
+    fi
+    if [ "${#files[@]}" -eq 0 ]; then
+        rm -f "$override"
+        return 0
+    fi
+    target_output_var "$config_file" "agents"
+    agents_output_path_var "${IS_TGT_OUTPUT:-.agents}"
+    agents_file="$repo_root/$IS_AGENTS_OUTPUT_PATH"
+    {
+        if [ -f "$agents_file" ]; then
+            cat "$agents_file"
+        else
+            printf '%s\n\n' "$CODEX_OVERRIDE_MARKER"
+        fi
+        echo "---"
+        echo ""
+        echo "## Codex Project Context"
+        echo ""
+        echo "<!-- Always-on rules AGENTS.md does not carry. Codex reads this file instead of AGENTS.md. -->"
+        echo ""
+        emit_rule_bodies "${files[@]}"
+    } > "$override"
+    finalize_output_file "$override"
+    for ((i = 0; i < ${#names[@]}; i++)); do
+        echo "  rule: ${names[i]} (always-on, AGENTS.override.md)"
+    done
+    echo "  -> AGENTS.override.md"
 }
 
 # Codex-specific guard for its documented project-instruction byte budget.
@@ -50,6 +112,8 @@ codex_warn_project_doc_size() {
     target_output_var "$config_file" "agents"
     local output
     output="$(agents_output_path "${IS_TGT_OUTPUT:-.agents}")"
+    # Codex reads AGENTS.override.md instead of AGENTS.md when it exists.
+    [ ! -f "$repo_root/AGENTS.override.md" ] || output="AGENTS.override.md"
 
     local output_file="$repo_root/$output"
     [ -f "$output_file" ] || return 0
@@ -81,19 +145,13 @@ sync_codex_agents() {
     local config_file="$2"
     local output_dir="$3"
 
-    local src f
-    local -a files=()
-    load_yaml_list "$config_file" "agents"
-    local list="$IS_YAML_LIST"
-    while IFS= read -r src; do
-        [ -z "$src" ] && continue
-        local dir="$repo_root/$src"
-        [ -d "$dir" ] || continue
-        for f in "$dir"/*.md; do
-            [ -f "$f" ] || continue
-            files+=("$f")
-        done
-    done <<< "$list"
+    local -a files=() names=()
+    output_rel_var "$repo_root" "$output_dir"
+    source_artifacts_var "$repo_root" "$config_file" agents codex "$IS_OUTPUT_REL/{}.toml"
+    if [ "${#IS_SOURCE_FILES[@]}" -gt 0 ]; then
+        files=("${IS_SOURCE_FILES[@]}")
+        names=("${IS_SOURCE_NAMES[@]}")
+    fi
 
     local count=0
     if [ "${#files[@]}" -gt 0 ]; then
@@ -101,8 +159,7 @@ sync_codex_agents() {
 
         local path tier access description effort name sandbox spec="" report="" LS=$'\x1e'
         while IFS=$'\x1f' read -r path tier access description effort; do
-            [ -n "$path" ] || continue
-            name="${path##*/}"; name="${name%.md}"
+            name="${names[count]}"
             resolve_model_var "$tier"
             map_effort_var codex "$effort"
             case "$access" in
@@ -153,5 +210,9 @@ sync_to_codex() {
     mkdir -p "$agents_dir"
     sync_codex_agents "$repo_root" "$config_file" "$agents_dir"
 
+    # Rules AGENTS.md does not carry -> AGENTS.override.md. The contract
+    # requires `agents`, so AGENTS.md has rendered by now.
+    sync_codex_override "$repo_root" "$config_file" || return 1
+
     codex_warn_project_doc_size "$repo_root" "$config_file"
 }

package/engine/adapters/copilot.sh

@@ -8,7 +8,9 @@
 #     natively, and the `agents` adapter inlines always-on rule content
 #     into AGENTS.md. We also do not generate .github/copilot-instructions.md
 #     because Copilot bug copilot-cli#489 makes AGENTS.md ignored when
-#     copilot-instructions.md is present.
+#     copilot-instructions.md is present. An always-on rule AGENTS.md does not
+#     carry — a local one, or one whose targets leave `agents` out — becomes
+#     an .instructions.md file with `applyTo: "**"` (decision 0021).
 # Skills: copy skill directories in full to .github/skills/{name}/
 # Agents: -> .github/agents/{name}.agent.md (description, tools, model)
 #
@@ -22,7 +24,9 @@
 # Every per-file loop batches its work into one awk process (see the batched
 # helpers in lib/common.sh): process spawns dominate sync time on Windows.
 
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/common.sh"
+# The engine and the CLI load the shared library before any adapter. Only a
+# standalone source of this file loads it here: that costs a dirname process.
+declare -F finalize_output_file >/dev/null 2>&1 || source "$(dirname "${BASH_SOURCE[0]}")/../lib/common.sh"
 
 adapter_contract_copilot() {
     local output="${1%/}" record=adapter_contract_ignore sub
@@ -98,8 +102,8 @@ copilot_paths_rows() {
     ' "$@"
 }
 
-# Sync rules to Copilot format. Only path-scoped rules are emitted —
-# always-on rules live in AGENTS.md (read by Copilot natively).
+# Sync rules to Copilot format. Path-scoped rules are emitted, and an always-on
+# rule only when AGENTS.md (read by Copilot natively) does not carry it.
 sync_copilot_rules() {
     local repo_root="$1"
     local config_file="$2"
@@ -110,35 +114,28 @@ sync_copilot_rules() {
 
     local scoped_count=0
 
-    local src f
-    local -a files=()
-    load_yaml_list "$config_file" "rules"
-    local list="$IS_YAML_LIST"
-    while IFS= read -r src; do
-        [ -z "$src" ] && continue
-        local dir="$repo_root/$src"
-        [ -d "$dir" ] || continue
-        for f in "$dir"/*.md; do
-            [ -f "$f" ] || continue
-            files+=("$f")
-        done
-    done <<< "$list"
-
-    local -a scoped=()
-    if [ "${#files[@]}" -gt 0 ]; then
-        local path hp
-        while IFS=$'\x1f' read -r path hp; do
-            [ -n "$path" ] || continue
-            [ "$hp" -eq 0 ] && continue
-            scoped+=("$path")
-        done < <(frontmatter_index "paths#" "${files[@]}")
-    fi
+    local i always_count=0 spec="" report="" LS=$'\x1e'
+    local -a scoped=() scoped_names=()
+    output_rel_var "$repo_root" "$instructions_dir"
+    source_artifacts_var "$repo_root" "$config_file" rules copilot "$IS_OUTPUT_REL/{}.instructions.md"
+    for ((i = 0; i < ${#IS_SOURCE_FILES[@]}; i++)); do
+        if [ "${IS_SOURCE_SCOPED[i]}" = 1 ]; then
+            scoped+=("${IS_SOURCE_FILES[i]}")
+            scoped_names+=("${IS_SOURCE_NAMES[i]}")
+        elif [ "${IS_SOURCE_IN_AGENTS[i]}" = 0 ]; then
+            # An always-on rule AGENTS.md does not carry applies everywhere.
+            spec+="${IS_SOURCE_FILES[i]}"$'\x1f'"$instructions_dir/${IS_SOURCE_NAMES[i]}.instructions.md"$'\x1f'"fence_nofm"$'\x1f'"0"$'\x1f'"none"$'\x1f'"${LS}---${LS}applyTo: \"**\"${LS}---${LS}"$'\x1f\n'
+            report+="  rule: ${IS_SOURCE_NAMES[i]}.instructions.md (always-on)"$'\n'
+            always_count=$((always_count + 1))
+        fi
+    done
 
     if [ "${#scoped[@]}" -gt 0 ]; then
-        local base paths_line spec="" report="" LS=$'\x1e'
+        local path base paths_line
+        i=0
         while IFS=$'\x1f' read -r path paths_line; do
-            [ -n "$path" ] || continue
-            base="${path##*/}"; base="${base%.md}"
+            base="${scoped_names[i]}"
+            i=$((i + 1))
 
             local header
             header="${LS}---"
@@ -150,12 +147,17 @@ sync_copilot_rules() {
             report+="  rule: $base.instructions.md (scoped)"$'\n'
             scoped_count=$((scoped_count + 1))
         done < <(copilot_paths_rows "${scoped[@]}")
-
+    fi
+    if [ -n "$spec" ]; then
         emit_wrapped_bodies "$spec"
         printf '%s' "$report"
     fi
 
-    echo "  rules: $scoped_count scoped"
+    if [ "$always_count" -gt 0 ]; then
+        echo "  rules: $scoped_count scoped, $always_count always-on"
+    else
+        echo "  rules: $scoped_count scoped"
+    fi
 }
 
 # Sync skills to Copilot format (SKILL.md in .github/skills/)
@@ -164,29 +166,23 @@ sync_copilot_skills() {
     local config_file="$2"
     local output_dir="$3"
 
-    local src d skill_name
+    local i name
     local -a skill_dirs=()
-    load_yaml_list "$config_file" "skills"
-    local list="$IS_YAML_LIST"
-    while IFS= read -r src; do
-        [ -z "$src" ] && continue
-        local dir="$repo_root/$src"
-        [ -d "$dir" ] || continue
-        for d in "$dir"/*/; do
-            [ -d "$d" ] || continue
-            [ -f "$d/SKILL.md" ] || continue
-            skill_dirs+=("$d")
-        done
-    done <<< "$list"
+    # The catalog's skills are the ones the inventory renders, symlinked ones
+    # included (decision 0017).
+    output_rel_var "$repo_root" "$output_dir"
+    source_artifacts_var "$repo_root" "$config_file" skills copilot "$IS_OUTPUT_REL/skills/{}"
+    for ((i = 0; i < ${#IS_SOURCE_FILES[@]}; i++)); do
+        skill_dirs+=("${IS_SOURCE_FILES[i]%/SKILL.md}/")
+    done
 
     local count=0
     if [ "${#skill_dirs[@]}" -gt 0 ]; then
         # Copilot has no effort field: the copy carries no `effort:`.
-        copy_skill_bundle_dirs_for copilot "$output_dir/skills" "${skill_dirs[@]}"
-        for d in "${skill_dirs[@]}"; do
-            skill_name="${d%/}"
+        copy_skill_bundle_dirs_named copilot "$output_dir/skills" "$IS_SOURCE_NAME_MAP" "${skill_dirs[@]}"
+        for name in "${IS_SOURCE_NAMES[@]}"; do
             count=$((count + 1))
-            echo "  skill: ${skill_name##*/}"
+            echo "  skill: $name"
         done
     fi
 
@@ -199,19 +195,13 @@ sync_copilot_agents() {
     local config_file="$2"
     local output_dir="$3"
 
-    local src f
-    local -a files=()
-    load_yaml_list "$config_file" "agents"
-    local list="$IS_YAML_LIST"
-    while IFS= read -r src; do
-        [ -z "$src" ] && continue
-        local dir="$repo_root/$src"
-        [ -d "$dir" ] || continue
-        for f in "$dir"/*.md; do
-            [ -f "$f" ] || continue
-            files+=("$f")
-        done
-    done <<< "$list"
+    local -a files=() names=()
+    output_rel_var "$repo_root" "$output_dir"
+    source_artifacts_var "$repo_root" "$config_file" agents copilot "$IS_OUTPUT_REL/agents/{}.agent.md"
+    if [ "${#IS_SOURCE_FILES[@]}" -gt 0 ]; then
+        files=("${IS_SOURCE_FILES[@]}")
+        names=("${IS_SOURCE_NAMES[@]}")
+    fi
 
     local count=0
     if [ "${#files[@]}" -gt 0 ]; then
@@ -219,8 +209,7 @@ sync_copilot_agents() {
 
         local path tier access description name tools_line spec="" report="" LS=$'\x1e'
         while IFS=$'\x1f' read -r path tier access description; do
-            [ -n "$path" ] || continue
-            name="${path##*/}"; name="${name%.md}"
+            name="${names[count]}"
             resolve_model_var "$tier"
 
             # Build tools list based on access. Tool aliases per Copilot custom-agent
@@ -268,7 +257,7 @@ sync_to_copilot() {
     # Clean generated content (preserve workflows, etc.)
     rm -rf "$output_dir/instructions" "$output_dir/prompts"
     if [ -d "$output_dir/skills" ]; then
-        find "$output_dir/skills" -mindepth 1 -maxdepth 1 -type d -exec rm -rf {} +
+        find "$output_dir/skills" -mindepth 1 -maxdepth 1 \( -type d -o -type l \) -exec rm -rf {} +
     fi
     rm -rf "$output_dir/agents"
     mkdir -p "$output_dir" "$output_dir/skills" "$output_dir/agents"

package/engine/adapters/cursor.sh

@@ -4,10 +4,13 @@
 #
 # Rules:
 #   - Path-scoped (with `paths:`)  -> .cursor/rules/<name>.mdc with `globs:`
-#   - Always-on (no `paths:`)      -> SKIPPED here. Cursor reads AGENTS.md
-#     natively for project-level context, and the `agents` adapter inlines
-#     always-on rule content into AGENTS.md. Generating .mdc copies of the
-#     same rules would cause double-loading and burn the context window.
+#   - Always-on (no `paths:`)      -> SKIPPED here while AGENTS.md carries it.
+#     Cursor reads AGENTS.md natively for project-level context, and the
+#     `agents` adapter inlines always-on rule content into AGENTS.md.
+#     Generating .mdc copies of the same rules would cause double-loading and
+#     burn the context window. An always-on rule AGENTS.md does not carry — a
+#     local one, or one whose targets leave `agents` out — becomes
+#     .cursor/rules/<name>.mdc with `alwaysApply: true` (decision 0021).
 # Skills: copy skill directories in full (SKILL.md + bundled resources)
 # Agents: strip tier/access/tools/disallowedTools, add model + readonly:true
 # Cursor has no per-agent or per-skill effort field (its effort is part of a
@@ -16,7 +19,9 @@
 # Every per-file loop batches its work into one awk process (see the batched
 # helpers in lib/common.sh): process spawns dominate sync time on Windows.
 
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/common.sh"
+# The engine and the CLI load the shared library before any adapter. Only a
+# standalone source of this file loads it here: that costs a dirname process.
+declare -F finalize_output_file >/dev/null 2>&1 || source "$(dirname "${BASH_SOURCE[0]}")/../lib/common.sh"
 
 adapter_contract_cursor() {
     local output="${1%/}"
@@ -39,45 +44,55 @@ sync_cursor_rules() {
     local config_file="$2"
     local output_dir="$3"
 
-    local src f
-    local -a files=()
-    load_yaml_list "$config_file" "rules"
-    local list="$IS_YAML_LIST"
-    while IFS= read -r src; do
-        [ -z "$src" ] && continue
-        local dir="$repo_root/$src"
-        [ -d "$dir" ] || continue
-        for f in "$dir"/*.md; do
-            [ -f "$f" ] || continue
-            files+=("$f")
-        done
-    done <<< "$list"
+    local i always=""
+    local -a files=() names=() kinds=()
+    output_rel_var "$repo_root" "$output_dir"
+    source_artifacts_var "$repo_root" "$config_file" rules cursor "$IS_OUTPUT_REL/rules/{}.mdc"
+    # A scoped rule takes Cursor's own channel. An always-on rule does only
+    # when AGENTS.md, which Cursor reads, does not carry it: a local rule, or
+    # one whose targets leave `agents` out (decision 0021).
+    for ((i = 0; i < ${#IS_SOURCE_FILES[@]}; i++)); do
+        if [ "${IS_SOURCE_SCOPED[i]}" = 1 ]; then
+            kinds+=(scoped)
+        elif [ "${IS_SOURCE_IN_AGENTS[i]}" = 0 ]; then
+            kinds+=(always-on)
+            always="$always${IS_SOURCE_FILES[i]}"$'\n'
+        else
+            continue
+        fi
+        files+=("${IS_SOURCE_FILES[i]}")
+        names+=("${IS_SOURCE_NAMES[i]}")
+    done
     [ "${#files[@]}" -gt 0 ] || return 0
 
-    # Skip always-on rules: AGENTS.md (canonical) carries them.
-    local path hp base
-    local -a scoped=()
-    while IFS=$'\x1f' read -r path hp; do
-        [ -n "$path" ] || continue
-        [ "$hp" -eq 0 ] && continue
-        scoped+=("$path")
-    done < <(frontmatter_index "paths#" "${files[@]}")
-    [ "${#scoped[@]}" -gt 0 ] || return 0
-
-    # Path-scoped rule -> Auto Attached (paths -> globs). The rewrite is
-    # anchored inside the frontmatter block: a body line may legitimately start
-    # with `paths:` (a rule documenting rule syntax does exactly that), and
-    # rewriting it would corrupt the text it teaches.
+    # Path-scoped rule -> Auto Attached (paths -> globs); always-on rule ->
+    # Always (`alwaysApply: true`), with a frontmatter block of its own when the
+    # source has none. The rewrite is anchored inside the frontmatter block: a
+    # body line may legitimately start with `paths:` (a rule documenting rule
+    # syntax does exactly that), and rewriting it would corrupt the text it
+    # teaches.
     is_fin_awk_vars
-    awk "${IS_FIN_V[@]}" -v dst="$output_dir/rules" "$IS_AWK_LIB"'
+    IS_MDC_ALWAYS="$always" IS_NAME_MAP="$IS_SOURCE_NAME_MAP" awk "${IS_FIN_V[@]}" -v dst="$output_dir/rules" "$IS_AWK_LIB"'
+        BEGIN {
+            n = split(ENVIRON["IS_MDC_ALWAYS"], al, "\n")
+            for (k = 1; k <= n; k++) if (al[k] != "") ALWAYS[al[k]] = 1
+        }
         FNR == 1 {
             if (out != "") close(out)
-            nm = base_name(FILENAME)
-            sub(/\.md$/, ".mdc", nm)
-            out = dst "/" nm
+            out = dst "/" art_name(FILENAME) ".mdc"
             fm = 0
+            tgt_reset()
         }
         { sub(/\r$/, "") }
+        FNR == 1 && (FILENAME in ALWAYS) {
+            print fin_line("---") > out
+            print fin_line("alwaysApply: true") > out
+            if ($0 == "---") { fm = 1; next }
+            print fin_line("---") > out
+            fm = 2
+            print fin_line($0) > out
+            next
+        }
         FNR == 1 {
             if ($0 == "---") fm = 1
             print fin_line($0) > out
@@ -85,12 +100,16 @@ sync_cursor_rules() {
             next
         }
         fm == 1 && $0 == "---" { fm = 2; print fin_line($0) > out; next }
+        fm == 1 && tgt_drop($0) { next }
         fm == 1 { sub(/^paths:/, "globs:") }
         { print fin_line($0) > out }
-    ' "${scoped[@]}"
-    for f in "${scoped[@]}"; do
-        base="${f##*/}"; base="${base%.md}"
-        echo "  rule: $base.mdc (scoped)"
+    ' "${files[@]}"
+    for ((i = 0; i < ${#files[@]}; i++)); do
+        # awk never reads a record from an empty source.
+        if [ "${kinds[i]}" = always-on ] && [ ! -s "${files[i]}" ]; then
+            printf -- '---\nalwaysApply: true\n---\n' > "$output_dir/rules/${names[i]}.mdc"
+        fi
+        echo "  rule: ${names[i]}.mdc (${kinds[i]})"
     done
 }
 
@@ -100,25 +119,19 @@ sync_cursor_skills() {
     local config_file="$2"
     local output_dir="$3"
 
-    local src d skill_name
+    local i name
     local -a skill_dirs=()
-    load_yaml_list "$config_file" "skills"
-    local list="$IS_YAML_LIST"
-    while IFS= read -r src; do
-        [ -z "$src" ] && continue
-        local dir="$repo_root/$src"
-        [ -d "$dir" ] || continue
-        for d in "$dir"/*/; do
-            [ -d "$d" ] || continue
-            [ -f "$d/SKILL.md" ] || continue
-            skill_dirs+=("$d")
-        done
-    done <<< "$list"
-    [ "${#skill_dirs[@]}" -gt 0 ] || return 0
-    copy_skill_bundle_dirs_for cursor "$output_dir/skills" "${skill_dirs[@]}"
-    for d in "${skill_dirs[@]}"; do
-        skill_name="${d%/}"
-        echo "  skill: ${skill_name##*/}"
+    # The catalog's skills are the ones the inventory renders, symlinked ones
+    # included (decision 0017).
+    output_rel_var "$repo_root" "$output_dir"
+    source_artifacts_var "$repo_root" "$config_file" skills cursor "$IS_OUTPUT_REL/skills/{}"
+    [ "${#IS_SOURCE_FILES[@]}" -gt 0 ] || return 0
+    for ((i = 0; i < ${#IS_SOURCE_FILES[@]}; i++)); do
+        skill_dirs+=("${IS_SOURCE_FILES[i]%/SKILL.md}/")
+    done
+    copy_skill_bundle_dirs_named cursor "$output_dir/skills" "$IS_SOURCE_NAME_MAP" "${skill_dirs[@]}"
+    for name in "${IS_SOURCE_NAMES[@]}"; do
+        echo "  skill: $name"
     done
 }
 
@@ -128,37 +141,32 @@ sync_cursor_agents() {
     local config_file="$2"
     local output_dir="$3"
 
-    local src f
-    local -a files=()
-    load_yaml_list "$config_file" "agents"
-    local list="$IS_YAML_LIST"
-    while IFS= read -r src; do
-        [ -z "$src" ] && continue
-        local dir="$repo_root/$src"
-        [ -d "$dir" ] || continue
-        for f in "$dir"/*.md; do
-            [ -f "$f" ] || continue
-            files+=("$f")
-        done
-    done <<< "$list"
-    [ "${#files[@]}" -gt 0 ] || return 0
+    local i
+    local -a files=() names=()
+    output_rel_var "$repo_root" "$output_dir"
+    source_artifacts_var "$repo_root" "$config_file" agents cursor "$IS_OUTPUT_REL/agents/{}.md"
+    [ "${#IS_SOURCE_FILES[@]}" -gt 0 ] || return 0
+    files=("${IS_SOURCE_FILES[@]}")
+    names=("${IS_SOURCE_NAMES[@]}")
+    local name_map="$IS_SOURCE_NAME_MAP"
 
     load_model_tiers "$config_file" "cursor"
 
     local path tier access spec="" report="" cursor_readonly
+    i=0
     while IFS=$'\x1f' read -r path tier access; do
-        [ -n "$path" ] || continue
         resolve_model_var "$tier"
         cursor_readonly=""
         [ "$access" = "readonly" ] && cursor_readonly="readonly: true"
         spec+="$path"$'\x1f'"$IS_MODEL"$'\x1f'"$cursor_readonly"$'\n'
-        report+="  agent: ${path##*/} (tier=$tier -> cursor)"$'\n'
+        report+="  agent: ${names[i]}.md (tier=$tier -> cursor)"$'\n'
+        i=$((i + 1))
     done < <(frontmatter_index "tier,access" "${files[@]}")
 
     # Always emit model: line (even when value matches Cursor's default)
     # so config is explicit and grep-able.
     is_fin_awk_vars
-    IS_MAP_SPEC="$spec" awk "${IS_FIN_V[@]}" -v dst="$output_dir/agents" "$IS_AWK_LIB"'
+    IS_NAME_MAP="$name_map" IS_MAP_SPEC="$spec" awk "${IS_FIN_V[@]}" -v dst="$output_dir/agents" "$IS_AWK_LIB"'
         BEGIN {
             US = sprintf("%c", 31)
             n = split(ENVIRON["IS_MAP_SPEC"], recs, "\n")
@@ -170,9 +178,10 @@ sync_cursor_agents() {
         }
         FNR == 1 {
             if (out != "") close(out)
-            out = dst "/" base_name(FILENAME)
+            out = dst "/" art_file(FILENAME, ".md")
             count = 0
             fm = 0
+            tgt_reset()
         }
         /^tier:/  { next }
         /^access:/ { next }
@@ -181,6 +190,7 @@ sync_cursor_agents() {
         { sub(/\r$/, "") }
         FNR == 1 && $0 == "---" { fm = 1 }
         /^---$/ { count++ }
+        fm && count == 1 && !/^---$/ && tgt_drop($0) { next }
         fm && count == 1 && substr($0, 1, 7) == "effort:" { next }
         count == 2 && /^---$/ {
             print fin_line("model: " MODEL[FILENAME]) > out
@@ -188,8 +198,8 @@ sync_cursor_agents() {
         }
         { print fin_line($0) > out }
     ' "${files[@]}"
-    for f in "${files[@]}"; do
-        [ -s "$f" ] || : > "$output_dir/agents/${f##*/}"
+    for ((i = 0; i < ${#files[@]}; i++)); do
+        [ -s "${files[i]}" ] || : > "$output_dir/agents/${names[i]}.md"
     done
     printf '%s' "$report"
 }