@ainova-systems/intelligence 0.23.0 → 0.24.0

package/engine/ENGINE_SHA

@@ -1 +1 @@
-79201cedae74ec96e67c3aa94e267f6b1e226c23
+6878d4ce559755d55f90ae23296678333e95f775

package/engine/VERSION

@@ -1 +1 @@
-0.23.0
+0.24.0

package/engine/adapters/codex.sh

@@ -3,8 +3,7 @@
 # Transforms source prompts to Codex format.
 #
 # Codex reads AGENTS.md natively for project context — the `agents` adapter
-# inlines always-on rules into AGENTS.md, so this adapter only emits skills
-# and subagent definitions.
+# inlines shared always-on rules into AGENTS.md.
 #
 # 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
@@ -12,6 +11,8 @@
 #   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.
+#   Scoped rules get compact pattern-to-source links in that same override.
+#   This is on-demand reading guidance, not a native glob-triggered loader.
 #
 # Skills: copy skill directories in full to .agents/skills/{name}/ (Codex
 #   reads from $REPO_ROOT/.agents/skills exclusively per official docs)
@@ -43,32 +44,50 @@ adapter_contract_codex() {
 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.
+# while Codex needs extra always-on rules or scoped-rule routing, 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=()
+    local -a files=() names=() scoped=() scoped_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]}")
+        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
+            files+=("${IS_SOURCE_FILES[i]}")
+        else
+            continue
+        fi
         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
+            [ "${#names[@]}" -gt 0 ] || return 0
+            echo "ERROR: AGENTS.override.md was not generated by intelligence-sync, but ${names[*]} need it: additional Codex rules and scoped-rule routing go there. Move its guidance into a rule, remove it, then sync." >&2
             return 1
         fi
     fi
-    if [ "${#files[@]}" -eq 0 ]; then
+    if [ "${#names[@]}" -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"
+    local routes="" rows path patterns link
+    if [ "${#scoped[@]}" -gt 0 ]; then
+        rows="$(frontmatter_index 'paths[]' "${scoped[@]}")" || return 1
+        i=0
+        while IFS=$'\x1f' read -r path patterns; do
+            repo_rel_link_var "$repo_root" "$path"
+            # The override is ignored: external sources may use their real path.
+            link="${IS_REPO_REL:-$path}"
+            routes+="- \`${patterns:-[]}\` → [${scoped_names[i]}](<$link>)"$'\n'
+            i=$((i + 1))
+        done <<< "$rows"
+    fi
     {
         if [ -f "$agents_file" ]; then
             cat "$agents_file"
@@ -79,13 +98,18 @@ sync_codex_override() {
         echo ""
         echo "## Codex Project Context"
         echo ""
-        echo "<!-- Always-on rules AGENTS.md does not carry. Codex reads this file instead of AGENTS.md. -->"
+        echo "<!-- Codex reads this file instead of AGENTS.md. -->"
         echo ""
-        emit_rule_bodies "${files[@]}"
+        if [ -n "$routes" ]; then
+            echo "Before working on files matching these repo-relative patterns, read and follow the linked rules. Apply each only within its scope."
+            echo ""
+            printf '%s\n' "$routes"
+        fi
+        [ "${#files[@]}" -eq 0 ] || 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)"
+        echo "  rule: ${names[i]} (AGENTS.override.md)"
     done
     echo "  -> AGENTS.override.md"
 }

package/engine/lib/common.sh

@@ -217,7 +217,9 @@ source_name_map_var() {
 # unit separator — never present in frontmatter values). Value semantics are
 # get_frontmatter_value's exactly: first frontmatter block only, first key
 # occurrence wins, first-colon split, symmetric quote strip. The special key
-# `paths#` yields the has_paths count instead of a value. A file without
+# `paths#` yields the has_paths count; `paths[]` folds the first paths list
+# into one display value, preserving YAML quotes and inline list syntax.
+# A file without
 # frontmatter (or an empty file) still gets a row, with empty values.
 frontmatter_index() {
     local keys="$1"
@@ -235,7 +237,7 @@ frontmatter_index() {
             store()
             cur = FILENAME
             for (ri = 1; ri <= nk; ri++) { V[ri] = (K[ri] == "paths#") ? 0 : ""; delete SEEN[ri] }
-            in_fm = 0; fm_done = 0
+            in_fm = 0; fm_done = 0; paths_list = 0
         }
         { sub(/\r$/, "") }
         FNR == 1 && $0 == "---" { in_fm = 1; next }
@@ -243,12 +245,29 @@ frontmatter_index() {
         in_fm && !fm_done && $0 == "---" { fm_done = 1; next }
         fm_done || !in_fm { next }
         {
+            if (paths_list && /^[[:space:]]*#/) next
+            if (paths_list && (/^[[:space:]]+/ || /^-[[:space:]]+/ || /^\]/)) {
+                item = $0
+                sub(/^[[:space:]]*/, "", item)
+                sub(/^-[[:space:]]+/, "", item)
+                if (item != "" && item !~ /^#/) {
+                    for (ki = 1; ki <= nk; ki++)
+                        if (K[ki] == "paths[]") V[ki] = V[ki] (V[ki] == "" ? "" : " ") item
+                }
+                next
+            }
+            if ($0 !~ /^[[:space:]]*$/) paths_list = 0
             idx = index($0, ":")
             if (idx == 0) next
             k = substr($0, 1, idx - 1)
             for (ki = 1; ki <= nk; ki++) {
                 if (K[ki] == "paths#") {
                     if (k == "paths") V[ki]++
+                } else if (K[ki] == "paths[]" && k == "paths" && !(ki in SEEN)) {
+                    SEEN[ki] = 1
+                    V[ki] = substr($0, idx + 1)
+                    sub(/^[[:space:]]+/, "", V[ki])
+                    paths_list = 1
                 } else if (k == K[ki] && !(ki in SEEN)) {
                     SEEN[ki] = 1
                     V[ki] = fm_value_strip(substr($0, idx + 1))
@@ -2767,7 +2786,7 @@ source_catalog_check_local() {
 # A project adapter's channels are its own business: it has one.
 builtin_has_channel() {
     case "$1:$2" in
-        opencode:always|opencode:scoped|codex:scoped) return 1 ;;
+        opencode:always|opencode:scoped) return 1 ;;
     esac
     return 0
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainova-systems/intelligence",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "Build, version and distribute AI agent intelligence across your organization — one CLI, versioned Intelligence Packages, and a sync engine for Claude Code, Cursor, Copilot, Codex, Pi and OpenCode.",
   "bin": {
     "intelligence": "bin/intelligence.js"

package/packages/sync/references/adapters.md

@@ -187,7 +187,7 @@ Use the engine library instead of copying parsers or file-handling logic.
 | `read_yaml_list(config, section)` | Stream entries from `sources.<section>`, package references as their store paths. |
 | `load_yaml_list(config, section)` | Same list into `IS_YAML_LIST`, cached — no subprocess on repeat reads. |
 | `get_frontmatter_value(key, file)` | Read a scalar from the first frontmatter block. |
-| `frontmatter_index(keys, file...)` | Read several frontmatter scalars for many files in one pass (`\x1f`-separated rows; special key `paths#` counts `paths:` lines). |
+| `frontmatter_index(keys, file...)` | Read several frontmatter scalars for many files in one pass (`\x1f`-separated rows; `paths#` counts `paths:` lines, `paths[]` folds a paths list for display). |
 | `has_frontmatter(file)` / `has_paths(file)` | Inspect source shape. |
 | `strip_frontmatter(file)` | Emit the body without its first frontmatter block. |
 | `get_model(config, tool, tier)` | Resolve a `frontier`, `heavy`, `standard` or `light` model, including manifest overrides. |
@@ -223,11 +223,13 @@ Intelligence routes always-on rules once through `AGENTS.md` for tools that cons
 | `claude` | Copy | Copy | Copy with `paths:` preserved |
 | `cursor` | Omit; reads `AGENTS.md` | `.mdc` with `alwaysApply: true` | `.mdc` with `globs:` |
 | `copilot` | Omit; reads `AGENTS.md` | `.instructions.md` with `applyTo: "**"` | `.instructions.md` with `applyTo:` |
-| `codex` | Omit; reads `AGENTS.md` | `AGENTS.override.md`: all of `AGENTS.md` plus these rules | No native channel |
+| `codex` | Omit; reads `AGENTS.md` | `AGENTS.override.md`: all of `AGENTS.md` plus these rules | Compact patterns and source links in `AGENTS.override.md`; read on demand |
 | `pi` | Omit; reads `AGENTS.md` | Added to the system prompt by the generated extension | Generated on-demand files and extension |
 | `opencode` | Omit; reads `AGENTS.md` | No channel; sync warns | No native channel |
 
-Codex reads `AGENTS.override.md` instead of `AGENTS.md` in the same directory, so the Codex adapter writes it — the whole rendered `AGENTS.md`, then the rules only Codex receives — while such a rule exists, and removes it when none does. Its contract manages and ignores the path; a file there that Intelligence did not generate is never touched, and a render that needs the path refuses until it is moved.
+Codex reads `AGENTS.override.md` instead of `AGENTS.md` in the same directory, so the Codex adapter writes the whole rendered `AGENTS.md`, a compact scoped-rule index, and any additional always-on rules into that override. It exists while either kind needs it. Its contract manages and ignores the path; a file there that Intelligence did not generate is never touched, and a render that needs the path refuses until it is moved.
+
+The scoped index pairs source `paths:` patterns with source links and asks Codex to read matching rules before working on files. Local and targeted rules follow the same source filtering as other output. This is model-followed guidance, not a native glob matcher; it creates no nested `AGENTS.md` files and leaves other tools' instruction channels unchanged. Checked 2026-10-23 against OpenAI's [instruction discovery documentation](https://learn.chatgpt.com/docs/agent-configuration/agents-md): startup discovery walks from the project root to the working directory, and an override replaces the base file in the same directory. Restart Codex after syncing updated instructions.
 
 If a new adapter relies on `AGENTS.md` for always-on rules, its target must require `agents`. Add that invariant to `engine/sync.sh` when contributing the adapter upstream.
 

package/packages/sync/references/conventions.md

@@ -279,13 +279,13 @@ Rule content in Markdown.
 
 | Source rule | Claude | Cursor | Antigravity | Copilot | Codex / Pi / OpenCode / `AGENTS.md` |
 |---|---|---|---|---|---|
-| Scoped | copied with `paths:` | `.mdc` with `globs:` | `.md` with `trigger: glob` and `globs:` | `.instructions.md` with `applyTo:` | listed in `AGENTS.md`; Pi also gets on-demand files and an extension |
+| Scoped | copied with `paths:` | `.mdc` with `globs:` | `.md` with `trigger: glob` and `globs:` | `.instructions.md` with `applyTo:` | listed in `AGENTS.md`; Codex gets routing in its override; Pi gets on-demand files and an extension |
 | Always-on | copied | omitted | omitted | omitted | inlined once into `AGENTS.md` |
 | Always-on, not in `AGENTS.md` | copied | `.mdc` with `alwaysApply: true` | `.md` with `trigger: always_on` | `.instructions.md` with `applyTo: "**"` | Codex: `AGENTS.override.md`; Pi: added to the system prompt by its extension; OpenCode: none |
 
-Cursor, Copilot, Codex, Pi, OpenCode and Antigravity consume `AGENTS.md`, so always-on rules are not duplicated in their tool-specific channels. Claude does not consume `AGENTS.md`, so it receives the full rule set. OpenCode and Codex have no generated path-scoped rule channel; OpenCode users may configure `instructions:` globs themselves.
+Cursor, Copilot, Codex, Pi, OpenCode and Antigravity consume `AGENTS.md`, so always-on rules are not duplicated in their tool-specific channels. Claude does not consume `AGENTS.md`, so it receives the full rule set. Codex's override lists scoped patterns and source links with an instruction to read matching rules on demand; this depends on the model following the instruction, not native glob-triggered loading. OpenCode users may configure `instructions:` globs themselves. See [adapter routing](adapters.md#rules) for delivery details.
 
-An always-on rule `AGENTS.md` does not carry — a local one, or one whose set leaves `agents` out (see [Selecting adapters](#selecting-adapters)) — reaches each tool in its set through that tool's own channel instead, the last row. Codex reads `AGENTS.override.md` instead of `AGENTS.md` in the same directory, so the file holds the whole `AGENTS.md` plus the rules only Codex receives; it is ignored, exists only while such a rule does, and one Intelligence did not generate is never touched. Antigravity's `trigger: always_on` belongs to the same undocumented key family as its `trigger: glob`. OpenCode reads instructions only from `AGENTS.md` or its committed `opencode.json`, so it can receive neither a local nor a tool-targeted always-on rule.
+An always-on rule `AGENTS.md` does not carry — a local one, or one whose set leaves `agents` out (see [Selecting adapters](#selecting-adapters)) — reaches each tool in its set through that tool's own channel instead, the last row. Codex reads `AGENTS.override.md` instead of `AGENTS.md` in the same directory, so the file holds the whole `AGENTS.md` plus scoped routing and additional always-on rules; it is ignored, exists while either needs it, and one Intelligence did not generate is never touched. Antigravity's `trigger: always_on` belongs to the same undocumented key family as its `trigger: glob`. OpenCode reads instructions only from `AGENTS.md` or its committed `opencode.json`, so it can receive neither a local nor a tool-targeted always-on rule.
 
 Keep always-on rules small. Put narrow framework or component guidance behind `paths:` so unrelated tasks do not pay its context cost.