@ainova-systems/intelligence 0.20.0 → 0.21.0

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
@@ -41,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
@@ -87,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
 }
 
@@ -102,29 +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=()
-    # The inventory decides which skills render, symlinked ones included
-    # (decision 0017); the glob keeps this adapter's own listing order.
-    skill_source_inventory "$repo_root" "$config_file"
-    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_source_rendered "$d" || 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
 }
 
@@ -134,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")
@@ -176,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 }
@@ -187,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
@@ -194,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"
 }

package/engine/adapters/opencode.sh

@@ -88,32 +88,24 @@ sync_opencode_commands() {
         [ "${#generated[@]}" -gt 0 ] && rm -f "${generated[@]}"
     fi
 
-    local src d skill_name
-    local -a skill_mds=()
-    # The inventory decides which skills render, symlinked ones included
-    # (decision 0017); the glob keeps this adapter's own listing order.
-    skill_source_inventory "$repo_root" "$config_file"
-    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_source_rendered "$d" || continue
-            skill_mds+=("${d%/}/SKILL.md")
-        done
-    done <<< "$list"
+    local skill_name
+    local -a skill_mds=() names=()
+    # The catalog's skills are the ones the inventory renders, symlinked ones
+    # included (decision 0017). The commands directory is tracked, so a local
+    # skill gets no command.
+    output_rel_var "$repo_root" "$commands_dir"
+    source_artifacts_var "$repo_root" "$config_file" skills opencode "$IS_OUTPUT_REL/{}.md"
+    if [ "${#IS_SOURCE_FILES[@]}" -gt 0 ]; then
+        skill_mds=("${IS_SOURCE_FILES[@]}")
+        names=("${IS_SOURCE_NAMES[@]}")
+    fi
 
     local count=0
     if [ "${#skill_mds[@]}" -gt 0 ]; then
         local path description argument_hint out_file
         local -a out_files=()
         while IFS=$'\x1f' read -r path description argument_hint; do
-            [ -n "$path" ] || continue
-            skill_name="${path%/SKILL.md}"; skill_name="${skill_name##*/}"
+            skill_name="${names[count]}"
             out_file="$commands_dir/$skill_name.md"
             yaml_dq_escape_var "$description"
             {
@@ -151,19 +143,13 @@ sync_opencode_agents() {
     local agents_dir="$output_dir/agents"
     mkdir -p "$agents_dir"
 
-    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" "$agents_dir"
+    source_artifacts_var "$repo_root" "$config_file" agents opencode "$IS_OUTPUT_REL/{}.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
@@ -171,8 +157,7 @@ sync_opencode_agents() {
 
         local path tier access description name edit_perm bash_perm 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"
 
             # Map source `access:` to opencode permission keys.

package/engine/adapters/pi.sh

@@ -4,6 +4,9 @@
 #
 # Rules:
 #   - Always-on (no `paths:`) -> SKIPPED here. Pi reads AGENTS.md natively.
+#     An always-on rule AGENTS.md does not carry — a local one, or one whose
+#     targets leave `agents` out — goes into the generated extension, which
+#     adds its body to the system prompt (decision 0021).
 #   - Path-scoped (with `paths:`) -> copied to .pi/intelligence-sync/rules/
 #     and surfaced via a generated Pi extension that lists them in the system
 #     prompt so the model can `read` the relevant rule on demand.
@@ -85,6 +88,39 @@ pi_rule_paths_rows() {
     ' "$@"
 }
 
+# pi_rule_body_rows <file>... — one line per file in argument order: its body,
+# without the frontmatter and leading or trailing blank lines, escaped as the
+# contents of a TypeScript double-quoted string (`\`, `"`, tabs and line breaks
+# escaped).
+pi_rule_body_rows() {
+    [ "$#" -gt 0 ] || return 0
+    awk "$IS_AWK_LIB"'
+        function store(   j, first, last, s) {
+            if (cur == "") return
+            first = 0; last = 0
+            for (j = 1; j <= n; j++) if (B[j] != "") { if (!first) first = j; last = j }
+            s = ""
+            for (j = first; first && j <= last; j++) s = s (j > first ? "\\n" : "") B[j]
+            R[cur] = s
+        }
+        FNR == 1 { store(); cur = FILENAME; n = 0; in_fm = 0; past_fm = 0 }
+        { sub(/\r$/, "") }
+        FNR == 1 && $0 != "---" { past_fm = 1 }
+        /^---$/ && !past_fm { in_fm = !in_fm; if (!in_fm) past_fm = 1; next }
+        !past_fm { next }
+        {
+            line = is_repl($0, "\\", "\\\\")
+            line = is_repl(line, "\"", "\\\"")
+            line = is_repl(line, "\t", "\\t")
+            B[++n] = line
+        }
+        END {
+            store()
+            for (i = 1; i < ARGC; i++) print (ARGV[i] in R) ? R[ARGV[i]] : ""
+        }
+    ' "$@"
+}
+
 sync_pi_rules() {
     local repo_root="$1"
     local config_file="$2"
@@ -98,38 +134,44 @@ sync_pi_rules() {
 
     mkdir -p "$rules_root" "$(dirname "$extension_file")"
 
-    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[@]}")
+    local -a scoped=() scoped_names=() always=() always_names=()
+    local k=0 always_rules=""
+    output_rel_var "$repo_root" "$rules_root"
+    source_artifacts_var "$repo_root" "$config_file" rules pi "$IS_OUTPUT_REL/{}.md"
+    while [ "$k" -lt "${#IS_SOURCE_FILES[@]}" ]; do
+        if [ "${IS_SOURCE_SCOPED[k]}" = 1 ]; then
+            scoped+=("${IS_SOURCE_FILES[k]}")
+            scoped_names+=("${IS_SOURCE_NAMES[k]}")
+        elif [ "${IS_SOURCE_IN_AGENTS[k]}" = 0 ]; then
+            # An always-on rule AGENTS.md does not carry: the extension adds
+            # its body to the system prompt (decision 0021).
+            always+=("${IS_SOURCE_FILES[k]}")
+            always_names+=("${IS_SOURCE_NAMES[k]}")
+        fi
+        k=$((k + 1))
+    done
+
+    if [ "${#always[@]}" -gt 0 ]; then
+        local body
+        k=0
+        while IFS= read -r body; do
+            pi_ts_escape_var "${always_names[k]}"
+            always_rules+="    { name: \"$IS_PI_TS_ESCAPED\", body: \"$body\" },"$'\n'
+            echo "  rule: ${always_names[k]} (always-on, in the extension)"
+            k=$((k + 1))
+        done < <(pi_rule_body_rows "${always[@]}")
     fi
 
     if [ "${#scoped[@]}" -gt 0 ]; then
-        finalize_copy_files "$rules_root" "${scoped[@]}"
+        finalize_copy_named "$rules_root" "$IS_SOURCE_NAME_MAP" "${scoped[@]}"
 
         local -a row_arr
         local base rel_rule_path patterns_js display sep display_sep pat i
+        k=0
         while IFS=$'\x1f' read -r -a row_arr; do
             [ "${#row_arr[@]}" -gt 0 ] || continue
-            base="${row_arr[0]##*/}"
+            base="${scoped_names[k]}.md"
+            k=$((k + 1))
             rel_rule_path="$output_rel/intelligence-sync/rules/$base"
             patterns_js=""
             display=""
@@ -153,7 +195,64 @@ sync_pi_rules() {
         done < <(pi_rule_paths_rows "${scoped[@]}")
     fi
 
-    if [ "$count" -gt 0 ]; then
+    if [ "${#always[@]}" -gt 0 ]; then
+        {
+            cat <<'EOF'
+/**
+ * Generated by intelligence-sync. Do not edit manually.
+ * Adds the always-on project rules AGENTS.md does not carry to the system
+ * prompt, and lists path-scoped project rules generated from intelligence/rules/.
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+const projectRules: Array<{ name: string; body: string }> = [
+EOF
+            printf '%s' "$always_rules"
+            cat <<'EOF'
+];
+
+const scopedRules: Array<{ path: string; patterns: string[] }> = [
+EOF
+            printf '%s' "$manifest"
+            cat <<'EOF'
+];
+
+export default function intelligenceSyncRulesExtension(pi: ExtensionAPI) {
+    pi.on("before_agent_start", async (event) => {
+        let systemPrompt = event.systemPrompt;
+
+        if (projectRules.length > 0) {
+            systemPrompt += `
+
+## Project Rules
+
+${projectRules.map((rule) => rule.body).join("\n\n")}`;
+        }
+
+        if (scopedRules.length > 0) {
+            const rulesList = scopedRules
+                .map((rule) => `- ${rule.path} — paths: ${rule.patterns.join(", ")}`)
+                .join("\n");
+
+            systemPrompt += `
+
+## Scoped Project Rules
+
+AGENTS.md already carries the always-on project rules. Additional path-scoped rules are available on demand:
+
+${rulesList}
+
+When the task touches files that match one of these path patterns, use the read tool to load the relevant rule file before making changes.`;
+        }
+
+        return { systemPrompt };
+    });
+}
+EOF
+        } > "$extension_file"
+        finalize_output_file "$extension_file"
+    elif [ "$count" -gt 0 ]; then
         {
             cat <<'EOF'
 /**
@@ -199,7 +298,11 @@ EOF
         finalize_output_file "$extension_file"
     fi
 
-    echo "  -> Rules: $count scoped"
+    if [ "${#always[@]}" -gt 0 ]; then
+        echo "  -> Rules: $count scoped, ${#always[@]} always-on"
+    else
+        echo "  -> Rules: $count scoped"
+    fi
 }
 
 sync_pi_skills() {
@@ -223,25 +326,18 @@ sync_pi_agents() {
 
     mkdir -p "$prompts_dir"
 
-    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" "$prompts_dir"
+    source_artifacts_var "$repo_root" "$config_file" agents pi "$IS_OUTPUT_REL/intelligence-agent-{}.md"
+    if [ "${#IS_SOURCE_FILES[@]}" -gt 0 ]; then
+        files=("${IS_SOURCE_FILES[@]}")
+        names=("${IS_SOURCE_NAMES[@]}")
+    fi
 
     if [ "${#files[@]}" -gt 0 ]; then
         local path desc access name template_desc spec="" report="" LS=$'\x1e'
         while IFS=$'\x1f' read -r path desc access; do
-            [ -n "$path" ] || continue
-            name="${path##*/}"; name="${name%.md}"
+            name="${names[count]}"
             repo_rel_link_var "$repo_root" "$path"
 
             template_desc="Use $name persona"