@automaton-labs/aib 0.0.7 → 0.0.8

package/dist/help/help-index.md

@@ -1,44 +1,49 @@
-Run as: aib help <topic...>
-
-Start here if this is your first AIB pass:
-  bootstrap
-
-Always after context compaction:
-  aib help help-protocol quick-map
-  aib config aliases
-
-Help conventions:
-  help-format
-
-Refresh workflow model:
-  basics patterns
-
-Core focused topics:
-  session
-  prefs
-  selectors
-  dsl
-  inspect
-  mutation
-
-Feature topics:
-  inspect.file
-  inspect.imports
-  inspect.exports
-  inspect.members
-  inspect.code
-  inspect.deps
-  inspect.usages
-  inspect.graph
-  inspect.tree
-  inspect.duplicates
-  inspect.cycles
-  rename
-  move
-  modulePlan
-  refactor.batch
-  imports.normalize
-  view
-  qr
-  rg
+Run as: aib help <topic...>
+
+Start here if this is your first AIB pass:
+  bootstrap
+
+Always after context compaction:
+  aib help help-protocol quick-map recipes rules
+  aib config aliases
+
+Help conventions:
+  help-format
+
+Refresh workflow model:
+  basics patterns
+
+Core focused topics:
+  session
+  rules
+  selectors
+  dsl
+  inspect.shared
+  mutation.shared
+  recipes
+
+Feature topics:
+  inspect.file
+  inspect.imports
+  inspect.exports
+  inspect.members
+  inspect.code
+  inspect.deps
+  inspect.usages
+  inspect.graph
+  inspect.tree
+  inspect.aliasCandidates
+  inspect.duplicates
+  inspect.cycles
+  rename
+  move
+  moveToDir
+  renameFile
+  mutate.mixed
+  modulePlan
+  import.rebase
+  imports.normalize
+  view
+  qr
+  rg
   reveal

package/dist/help/help-meta.json

@@ -1,37 +1,41 @@
 {
   "schemaVersion": 1,
   "helpVersion": "0.1.0",
-  "generatedAt": "2026-06-11T13:27:23+03:00",
-  "sourceCommit": "f3bddf34",
-  "contentHash": "sha256:3d73b26f64e061560b920add21f1ff74187b93f8adab6044c69a6d2ae436e534",
+  "generatedAt": "2026-07-19T22:17:11+03:00",
+  "sourceCommit": "def0b5c5",
+  "contentHash": "sha256:147abf680d58c3b4d2624fb4a9cf3893a7cca28310446d7925d68283b03b255a",
   "topics": {
     "help-format": {
       "contentHash": "sha256:b1a0a6ca2a5ac2e61285854e8dd3c951a329073f139ccca50ebe519c2ca0484e",
       "docsHash": "sha256:44a26ac23ba47f1cff5cedcf61bba16df2d3403db01cf73627da02a3eff0986e"
     },
     "help-protocol": {
-      "contentHash": "sha256:4d31b0ac5d262f8cbe0da0d883324723efa869a0a0e8edc588795872db47b885",
-      "docsHash": "sha256:acb61b3f7b1cab9fecf82042c88b90bef28922093a9372f0f6829a4f7e1653d0"
+      "contentHash": "sha256:ffad525ca26ac24f7d80e07c75c10943e35789d261f11c64dd4835ecf27f8312",
+      "docsHash": "sha256:6bfde3e500e79bdf975a5864a3434c7d228cc3b042c5186279703b15e2e20a30"
     },
     "quick-map": {
-      "contentHash": "sha256:54ccf688bacd8d37841070bb3a3330d17db1a109757612ca6a953530906db81c",
-      "docsHash": "sha256:10b48450656617df4e0efe51d1b89330f1d5c5cd9fdf9ab90feecec6cea52065"
+      "contentHash": "sha256:4e5725ef19aa3d9468f0ccb0a52aecde9f3fc605b11f6ff86d38d9f3bfd1889a",
+      "docsHash": "sha256:b9a92518a96b95edc7d6475f9f07aafb2ddf31b30b26242a65eb6a562b4222ca"
+    },
+    "rules": {
+      "contentHash": "sha256:5871420f7523cc06c39d96ed361ef18174e4dd3cbaced0a8600d720df675ad76",
+      "docsHash": "sha256:4e3060b71b5926e114be04d207790abb14b01bdf1e3fb5faaf304ba8602ff95e"
     },
     "basics": {
-      "contentHash": "sha256:e9c53461377826c660b9c79b6f6b88c21c37899cf6c97e90acccc56ef8bb9ce2",
-      "docsHash": "sha256:b029006c90a1809532b8de49dee9f0bb0f0fc9fd97543159a81be81a66b8a2f6"
+      "contentHash": "sha256:dbda7e409b83d50b12e2e56472472170b25610d63ea8fbfa720d087bdf2f44a0",
+      "docsHash": "sha256:1df59df1e4da9762cfd78f4e44ab5c10c159dfb2dbe5206ae602bec3c1b0d0d4"
     },
     "first-setup": {
-      "contentHash": "sha256:ed33d8bd8c404bcd7c83a775578a284d70f1097c5270f0490de378cf5e2c4758",
-      "docsHash": "sha256:e46fb5382e626766f38baf4151c09baf340e3896242c9beac7b0670282ce7d9d"
+      "contentHash": "sha256:118c8889e53caae9a83bf47b191adaa752f860c1be1c90abe6cd73c01fffd859",
+      "docsHash": "sha256:2b287ae4a4c6572159db63942fe09b523ede5859cb818df2042cf310d24b0a8c"
     },
     "config-setup.import-rules": {
-      "contentHash": "sha256:f4825e8842a86fa7d15301bf9745ecead828d47191b3e5c390c2d9fa36fc367a",
-      "docsHash": "sha256:8a7a52ae8b93fe82ad04f6ccd03b521d1b4ce655e1152a0fd91d8a81f77c2ec5"
+      "contentHash": "sha256:1d4a2478b6c7089f2c6208dcd696f8e9af6ab5fd88649311bb8ebf41283c477e",
+      "docsHash": "sha256:b8e71b46112d31c89102c3a64e9412f05915fbbf5ff2eef59c1739a8e71d5f51"
     },
     "config-setup.import-normalize": {
-      "contentHash": "sha256:55ca60276bf7d81202b88b83773d7432c3dbc130758e784ef574105058976cfc",
-      "docsHash": "sha256:ddeca97d7053c85992dad118894f56a35a79fd0a95a7558a47965102b28dfec3"
+      "contentHash": "sha256:257a9ec29169fb94bb6f2026ed591a0d284a28d4618399ff1cb725c2e6308782",
+      "docsHash": "sha256:4ae11442f7b6182fd3f92ffa8fb38690a8658664c6ddb0ec27c41d39ff255eee"
     },
     "config-setup.aliases": {
       "contentHash": "sha256:15a461a8c37a0793864338f84a30614c082217dcd195a1d396c1548a05a75c8e",
@@ -50,8 +54,8 @@
       "docsHash": "sha256:735401d4b8845b0d54f1151395f07fc1144b4370690ffd80f5ee40ae83a00d2c"
     },
     "patterns": {
-      "contentHash": "sha256:2725e71c1162cd8db8ec0847bf050cc005b582878a3a170601780399b8cf115d",
-      "docsHash": "sha256:f93ff64ba4cbe34c001ac36b6f6208a05a31e0e9040ee46bcc0cfc0f0044b58f"
+      "contentHash": "sha256:12fd63674a32f54c988ce64e060b78ac1a6cc6caf53150e8f7448d59533d5882",
+      "docsHash": "sha256:48c04c7d0e134116a58f38453170196957747f0f33841f21a10209e41a82b21c"
     },
     "session": {
       "contentHash": "sha256:f91f49c531f30b0590e6a711dd906b0debcc8a66dabf2999fce43612072826bb",
@@ -66,8 +70,8 @@
       "docsHash": "sha256:3cfd022c10ad50634b4daca32ac5511146f32af3b66b632582914b106e8b9619"
     },
     "qr": {
-      "contentHash": "sha256:700050d6a62553e12c35c8acb9e4b47471feeef82bb61a7612e953e81f0eb5bd",
-      "docsHash": "sha256:a0b5d09f2c8b191bfc161402bda58820e93a302048a3c43aedb52281dc1fb020"
+      "contentHash": "sha256:31ab2f8e7b30025bb4a19cda81e42056a0e900f23795834ce076933c713c8298",
+      "docsHash": "sha256:7124c6cbf2bccf5615dc197fdc2305ccfabd0f4fd31eb6d7d428167e2f7c6004"
     },
     "rg": {
       "contentHash": "sha256:c91568738b7942f1586bfa698265e9886052f084a694d14d3eb3ae6282060c25",
@@ -81,49 +85,73 @@
       "contentHash": "sha256:b8897c49113766bd0762cc1f09478418f9228686acba60a853a82f63d4f4939b",
       "docsHash": "sha256:75f83ac3defc745931e1899819456b19c0663c99b8ffd1930416716b2f029309"
     },
-    "mutation": {
-      "contentHash": "sha256:c46b878b05eec0db95664c148e2c2b82a1bc541ee843cecdfc4fbe0a24bdab2a",
-      "docsHash": "sha256:239e932b33bda72f6d6b37b53aaa9e4fcd5cd1cc09c5f0ef5633262781e1859c"
+    "mutation.shared": {
+      "contentHash": "sha256:a89a81978d27d97f3c87726cb5a91e2574b2169b8a9aaef4bd5f5763ed2ac2b7",
+      "docsHash": "sha256:405381e2ccbbed86e353d7b3553b709f790ddc91392d68439f3a25807d62d3f7"
     },
     "rename": {
-      "contentHash": "sha256:c1a2694179915bb3a8b1fb2cedf1c61e3a3d6ed68ed262acb01705151b1c757d",
-      "docsHash": "sha256:b2752a5867b51d0cfbbdd494f7a49712cc5b2f0417c6610d73b1bf5b611d8ff7"
+      "contentHash": "sha256:c527d5b768468b2a4fc03908362632daa15f13810c3bc196456e556e0479e52d",
+      "docsHash": "sha256:35ccaee7bf51f2ef2cc01dc33d1d465b39dad15c62401fb38a4e84c97078a1a2"
     },
     "move": {
-      "contentHash": "sha256:98f724a6f995a7c95a3619361b6ece39bede336e94ac3559be1d7fcb80422a54",
-      "docsHash": "sha256:39cae1c7bef61d1a7531c984367b5a15ae1d9e1d3f0acb9c34b12b08d78b3a35"
+      "contentHash": "sha256:ef95ff2597abe09954c05a3a4ad324ca82c1e2dcc5576af994e82fc6240cd4d3",
+      "docsHash": "sha256:ec563acf784d398d1961349ab2ded49ad9191448725b373c87e636e7f9a7ab26"
     },
     "modulePlan": {
-      "contentHash": "sha256:4159fc3912060b92c9d8e402efb22f830f0a2aa2cc52548cf4d19353cdfc1dbb",
-      "docsHash": "sha256:31b77f8ca94acf5a6c134a780523b5594bb4e0520a5d5844e714898cb7eae2d6"
+      "contentHash": "sha256:a5ac78deaa93d6df1207d44fdf48533b2c365fe311b9ce848485d24f2a3e5b41",
+      "docsHash": "sha256:0194f416e7ba216643ddb22c0d7fa89b8b8b7a5e5ea7f830498747f7a696e9d1"
+    },
+    "mutate.mixed": {
+      "contentHash": "sha256:d3571ad65083d2c43267111d2d044c96431a20162ff2187d6a6a38046f31a925",
+      "docsHash": "sha256:c8b6f6ce5fa5b3c49a1233b623c0ba5acc01933baad695f1e84f1901ae97031c"
     },
-    "refactor.batch": {
-      "contentHash": "sha256:9e169d6a8b45d468dae0fea26315454a0b11ee4bbb72c71a83d54c8aa38f6a75",
-      "docsHash": "sha256:e7c87c2c3851d69f3648ea421639bf8e06f8b803549abe1b6520c21bf1af01a4"
+    "moveToDir": {
+      "contentHash": "sha256:9c0e7a4e9a88a99be92c99bfa29df535b4eac6e42e2b49caeb0c2a3aab342e10",
+      "docsHash": "sha256:1ad6edcc0da41c79064256059d12309a4dcd7ec71e9d264ab495e8fa6cf429e5"
     },
-    "file.move": {
-      "contentHash": "sha256:be35bc1795afd46035be9783203949e7f706171b9c624c0143ad4e9fa30801b4",
-      "docsHash": "sha256:05eab7aef652576651946c93b0d13966f560aea70921991f7b75001844deb101"
+    "renameFile": {
+      "contentHash": "sha256:f948399464164fae8c06798dc54882e263f8b8f107b1780d39f234da52753e92",
+      "docsHash": "sha256:c2b9371f2ec4e7e23c7263264753a9e5a8a37f1609be3ef4bada107d56719651"
     },
-    "file.rename": {
-      "contentHash": "sha256:7fef39e4e0cabf29353b8482879e5b02d4734d7cac16feba93f3a2dd8743d6bd",
-      "docsHash": "sha256:41800cf762cf08589854772cac0b4919f81e153fd0c7e5747dd8c07e309d424a"
+    "recipes": {
+      "contentHash": "sha256:45f6bde6b3b499cbf3d83dfe9736a52d189a862c0a3e3d714d387721f50e073e",
+      "docsHash": "sha256:2857ebe0e40d522261228654e24a2dd6ae041b1ac0eb9a39ee730727e3b5706d"
     },
     "recipe.file-layout": {
-      "contentHash": "sha256:c0c5986a60fd49b1db6948b90b51adbe417df4b82cc96d6ed91d1ef06fde66d4",
-      "docsHash": "sha256:07362762cf88857745380c14989e69565d6f06bc5fdb12bf79169e1875c2e325"
+      "contentHash": "sha256:2781f734ed162e240175e38a26ee82745232888311cf5cc9886a6b535f219271",
+      "docsHash": "sha256:533ba664b42af5afd60f6ee7c952613ac43f400cf1b8e66bdb38bb998beb385d"
+    },
+    "recipe.import-boundary": {
+      "contentHash": "sha256:148d0a094e269c5087867b3ad35ad0ba9af6657978ed32ae45d69c4d102f1184",
+      "docsHash": "sha256:6b67c6d833243ea1108f92ea796d200e7f2c5850f4a0fa8fd5241a19a80f9f5f"
+    },
+    "recipe.unfamiliar-area": {
+      "contentHash": "sha256:c4f28cf150a429ffb0146c79e819e42d6666812cb9fd82f092bd6e7cb728abfd",
+      "docsHash": "sha256:8dfce4f4d483e37f2f3cf0d3a2b0ec29562937a28d9a093a1af8c2440949f534"
+    },
+    "recipe.safe-artifact-probing": {
+      "contentHash": "sha256:21d0cd84dd7ed8fbc6fe4cf34befc32efe694ae1dee2d2883b2189dbfa6976e0",
+      "docsHash": "sha256:72029c983e8c73624067cbf1a37568e8d139ba110b4b9d5f2408b070d4035911"
     },
     "imports.normalize": {
       "contentHash": "sha256:e0f3e6720307cfff1b68db1a6125e222f9798f1e29c5bcec3aab069acf1ba940",
       "docsHash": "sha256:21f8143b5f840ded4bb124ff17106dcc5a80b9131381c09f95a86c438f95a965"
     },
-    "inspect": {
-      "contentHash": "sha256:b6726ec8dd39f75c5a83f0026bf2d354e3da6b38a60cf404f65a4ca690c48f66",
-      "docsHash": "sha256:53b027f1444d3386d6d952ed1ecec10ae67fdfd2ca22b657411990703e00da18"
+    "import.base": {
+      "contentHash": "sha256:59f37222b0b267203e6e9fcabe15be5e1c0df06a422783e220c706073190b6ab",
+      "docsHash": "sha256:7717c0f727cdaa932109277ba79fe013efac61ed6509fff4c2f723951db31600"
+    },
+    "import.rebase": {
+      "contentHash": "sha256:4cfbc2764f44b34713b8391d5c5d5be5d305b0c59e87eaf8c15e758576bc0b05",
+      "docsHash": "sha256:2de70575d7a8c3e3bf89ebba6f003d7c88df3887c125ae357b28edc8bf718a7e"
+    },
+    "inspect.shared": {
+      "contentHash": "sha256:3b6f188a4b6eecc343f93613e6c9dc570d95dc5c855fe9adb573555263eb7a93",
+      "docsHash": "sha256:0b02c9bce1fbf0e8af6100a9e9a0a93ebb6494517439b477fc006ab6d278269a"
     },
     "inspect.file": {
-      "contentHash": "sha256:837462936cbe9190275e86eb80553a92d18a562b72257cb6dea26e651d7d4f31",
-      "docsHash": "sha256:bfbcad0c5b1e23be01795b57a94fe9118480b85d6e30dcc0e5c9368e3098de88"
+      "contentHash": "sha256:fc8e9d2f1382da147a313c8b619592e7355575bbfdea2ff354f54bb0f1ea17bb",
+      "docsHash": "sha256:b1ef88e471b473d183ae8aab1729ee1d340110ddfb9232158029248663dac146"
     },
     "inspect.imports": {
       "contentHash": "sha256:cbd03ab54f1373727cc6f62cf4140eb081e417c3cd9705c76aabb83e42954a7e",
@@ -138,8 +166,8 @@
       "docsHash": "sha256:1157d2721c1ec09e5ee92ec5c8f94bd621ff0d4b9cbb76fbf6de22d08def22b0"
     },
     "inspect.code": {
-      "contentHash": "sha256:5d171649777387b0ed0b32d8638406be2c06748956d14edd5c3281a5f418ec6e",
-      "docsHash": "sha256:eff10029d356db3e7fcf22726a19223fb07f01bb340b4b281f9a56cbaa2e3b5a"
+      "contentHash": "sha256:10557da3f692dcdca2d00bae2ed5d72b69fa3ab753a4d766e6bbbbaf64c80d1b",
+      "docsHash": "sha256:fd05f42fb487c1fcd3dcc60485338f0de96ff9c66a017aaf4368b4725efd2470"
     },
     "inspect.deps": {
       "contentHash": "sha256:d7e17ad4d37f085073a0843ecdb893de2dccfd2e9ade79ddd50670530c002fea",
@@ -150,13 +178,17 @@
       "docsHash": "sha256:9b82674122c986159ca0ec82d89e4b382d0ed786b66a1cc3c9dd4f5f93bfef47"
     },
     "inspect.graph": {
-      "contentHash": "sha256:a7d4792c063f8244b84579c9dc5a847755653092a9026010c87bfa0bbbafdd60",
-      "docsHash": "sha256:2bda09bfcec9645bb2227fb8fca8f03a02a78c6b94118ab2ad5bd1e946d33c3f"
+      "contentHash": "sha256:da8ececaabe778f2fb288c5d5bb26d1b21cb54da1adbde9c00d49c0bf07314ee",
+      "docsHash": "sha256:ad98b65afbcf234a7b8090f7f29aa11a1bed277255d87d6a71ad71f6ac05b6ca"
     },
     "inspect.tree": {
       "contentHash": "sha256:db064a9b7ddc8ba2530fadc7aebf214d0cf9551f2fc771b113cbd4b4511254d1",
       "docsHash": "sha256:91c81dae81527cc7e1ddce28810540543a19487a49294402787d384c7abd4a9d"
     },
+    "inspect.aliasCandidates": {
+      "contentHash": "sha256:832c83527abe3e26a88793322be871c0b96f0add8a5d6226376e07d660e48301",
+      "docsHash": "sha256:3eb52f184a744cbee796977ac6d718b8e1c06cc5b9f78570d110596f16a4a95b"
+    },
     "inspect.duplicates": {
       "contentHash": "sha256:08b6216d3c4ccd2460befec53559451b34af7157f2742b026bfe2a6babda1033",
       "docsHash": "sha256:4b57e3557cf4fdfbc7e13a1ebc1a27be2fbfd9f6d828f2807c1097f722bc5e25"
@@ -165,5 +197,23 @@
       "contentHash": "sha256:429bd6fa5b91e66516264ad1dab6cf09cf5446e1ea547d342f1d4abb71b94526",
       "docsHash": "sha256:f7cc3dc73f6aa4cde94b0cc206520568b242abe16453b69f045baa20a8c37146"
     }
+  },
+  "skills": {
+    "recipe.unfamiliar-area": {
+      "target": "codex",
+      "name": "aib-unfamiliar-area",
+      "description": "Use when entering a codebase or when about to debug, modify, or extend code in an unfamiliar area.",
+      "topic": "recipe.unfamiliar-area",
+      "body": "When you do not already have enough recipe context to follow the workflow, read and use:\n\naib help recipe.unfamiliar-area\n\nIf the workflow is already in context, continue from it without rereading.",
+      "contentHash": "sha256:d61a78dd07211fa0362941ce2ad7a1f68b165257bf0dc830358288a72c2e9f1d"
+    },
+    "recipe.safe-artifact-probing": {
+      "target": "codex",
+      "name": "aib-safe-artifact-probing",
+      "description": "Use before probing generated, bundled, minified, dependency/vendor, lock/patch, or huge-line artifacts with tools or runtimes.",
+      "topic": "recipe.safe-artifact-probing",
+      "body": "When you do not already have enough recipe context to follow the workflow, read and use:\n\naib help recipe.safe-artifact-probing\n\nIf the workflow is already in context, continue from it without rereading.",
+      "contentHash": "sha256:c79fde3bc3a8c3630000f50820a9309ec5f67284a2977ac9f462884118395d72"
+    }
   }
 }

package/dist/help/index.md

@@ -16,6 +16,8 @@
 - Docs help-protocol: [File](<docs/help-protocol.md>)
 - Help quick-map: [File](<topics/quick-map.md>)
 - Docs quick-map: [File](<docs/quick-map.md>)
+- Help rules: [File](<topics/rules.md>)
+- Docs rules: [File](<docs/rules.md>)
 - Help basics: [File](<topics/basics.md>)
 - Docs basics: [File](<docs/basics.md>)
 - Help first-setup: [File](<topics/first-setup.md>)
@@ -48,26 +50,38 @@
 - Docs reveal: [File](<docs/reveal.md>)
 - Help selectors: [File](<topics/selectors.md>)
 - Docs selectors: [File](<docs/selectors.md>)
-- Help mutation: [File](<topics/mutation.md>)
-- Docs mutation: [File](<docs/mutation.md>)
+- Help mutation.shared: [File](<topics/mutation.shared.md>)
+- Docs mutation.shared: [File](<docs/mutation.shared.md>)
 - Help rename: [File](<topics/rename.md>)
 - Docs rename: [File](<docs/rename.md>)
 - Help move: [File](<topics/move.md>)
 - Docs move: [File](<docs/move.md>)
 - Help modulePlan: [File](<topics/modulePlan.md>)
 - Docs modulePlan: [File](<docs/modulePlan.md>)
-- Help refactor.batch: [File](<topics/refactor.batch.md>)
-- Docs refactor.batch: [File](<docs/refactor.batch.md>)
-- Help file.move: [File](<topics/file.move.md>)
-- Docs file.move: [File](<docs/file.move.md>)
-- Help file.rename: [File](<topics/file.rename.md>)
-- Docs file.rename: [File](<docs/file.rename.md>)
+- Help mutate.mixed: [File](<topics/mutate.mixed.md>)
+- Docs mutate.mixed: [File](<docs/mutate.mixed.md>)
+- Help moveToDir: [File](<topics/moveToDir.md>)
+- Docs moveToDir: [File](<docs/moveToDir.md>)
+- Help renameFile: [File](<topics/renameFile.md>)
+- Docs renameFile: [File](<docs/renameFile.md>)
+- Help recipes: [File](<topics/recipes.md>)
+- Docs recipes: [File](<docs/recipes.md>)
 - Help recipe.file-layout: [File](<topics/recipe.file-layout.md>)
 - Docs recipe.file-layout: [File](<docs/recipe.file-layout.md>)
+- Help recipe.import-boundary: [File](<topics/recipe.import-boundary.md>)
+- Docs recipe.import-boundary: [File](<docs/recipe.import-boundary.md>)
+- Help recipe.unfamiliar-area: [File](<topics/recipe.unfamiliar-area.md>)
+- Docs recipe.unfamiliar-area: [File](<docs/recipe.unfamiliar-area.md>)
+- Help recipe.safe-artifact-probing: [File](<topics/recipe.safe-artifact-probing.md>)
+- Docs recipe.safe-artifact-probing: [File](<docs/recipe.safe-artifact-probing.md>)
 - Help imports.normalize: [File](<topics/imports.normalize.md>)
 - Docs imports.normalize: [File](<docs/imports.normalize.md>)
-- Help inspect: [File](<topics/inspect.md>)
-- Docs inspect: [File](<docs/inspect.md>)
+- Help import.base: [File](<topics/import.base.md>)
+- Docs import.base: [File](<docs/import.base.md>)
+- Help import.rebase: [File](<topics/import.rebase.md>)
+- Docs import.rebase: [File](<docs/import.rebase.md>)
+- Help inspect.shared: [File](<topics/inspect.shared.md>)
+- Docs inspect.shared: [File](<docs/inspect.shared.md>)
 - Help inspect.file: [File](<topics/inspect.file.md>)
 - Docs inspect.file: [File](<docs/inspect.file.md>)
 - Help inspect.imports: [File](<topics/inspect.imports.md>)
@@ -86,6 +100,8 @@
 - Docs inspect.graph: [File](<docs/inspect.graph.md>)
 - Help inspect.tree: [File](<topics/inspect.tree.md>)
 - Docs inspect.tree: [File](<docs/inspect.tree.md>)
+- Help inspect.aliasCandidates: [File](<topics/inspect.aliasCandidates.md>)
+- Docs inspect.aliasCandidates: [File](<docs/inspect.aliasCandidates.md>)
 - Help inspect.duplicates: [File](<topics/inspect.duplicates.md>)
 - Docs inspect.duplicates: [File](<docs/inspect.duplicates.md>)
 - Help inspect.cycles: [File](<topics/inspect.cycles.md>)
@@ -107,6 +123,8 @@
 - dsl Docs help-protocol: [File](<dsl/docs/help-protocol.md>)
 - dsl Help quick-map: [File](<dsl/topics/quick-map.md>)
 - dsl Docs quick-map: [File](<dsl/docs/quick-map.md>)
+- dsl Help rules: [File](<dsl/topics/rules.md>)
+- dsl Docs rules: [File](<dsl/docs/rules.md>)
 - dsl Help basics: [File](<dsl/topics/basics.md>)
 - dsl Docs basics: [File](<dsl/docs/basics.md>)
 - dsl Help first-setup: [File](<dsl/topics/first-setup.md>)
@@ -139,26 +157,38 @@
 - dsl Docs reveal: [File](<dsl/docs/reveal.md>)
 - dsl Help selectors: [File](<dsl/topics/selectors.md>)
 - dsl Docs selectors: [File](<dsl/docs/selectors.md>)
-- dsl Help mutation: [File](<dsl/topics/mutation.md>)
-- dsl Docs mutation: [File](<dsl/docs/mutation.md>)
+- dsl Help mutation.shared: [File](<dsl/topics/mutation.shared.md>)
+- dsl Docs mutation.shared: [File](<dsl/docs/mutation.shared.md>)
 - dsl Help rename: [File](<dsl/topics/rename.md>)
 - dsl Docs rename: [File](<dsl/docs/rename.md>)
 - dsl Help move: [File](<dsl/topics/move.md>)
 - dsl Docs move: [File](<dsl/docs/move.md>)
 - dsl Help modulePlan: [File](<dsl/topics/modulePlan.md>)
 - dsl Docs modulePlan: [File](<dsl/docs/modulePlan.md>)
-- dsl Help refactor.batch: [File](<dsl/topics/refactor.batch.md>)
-- dsl Docs refactor.batch: [File](<dsl/docs/refactor.batch.md>)
-- dsl Help file.move: [File](<dsl/topics/file.move.md>)
-- dsl Docs file.move: [File](<dsl/docs/file.move.md>)
-- dsl Help file.rename: [File](<dsl/topics/file.rename.md>)
-- dsl Docs file.rename: [File](<dsl/docs/file.rename.md>)
+- dsl Help mutate.mixed: [File](<dsl/topics/mutate.mixed.md>)
+- dsl Docs mutate.mixed: [File](<dsl/docs/mutate.mixed.md>)
+- dsl Help moveToDir: [File](<dsl/topics/moveToDir.md>)
+- dsl Docs moveToDir: [File](<dsl/docs/moveToDir.md>)
+- dsl Help renameFile: [File](<dsl/topics/renameFile.md>)
+- dsl Docs renameFile: [File](<dsl/docs/renameFile.md>)
+- dsl Help recipes: [File](<dsl/topics/recipes.md>)
+- dsl Docs recipes: [File](<dsl/docs/recipes.md>)
 - dsl Help recipe.file-layout: [File](<dsl/topics/recipe.file-layout.md>)
 - dsl Docs recipe.file-layout: [File](<dsl/docs/recipe.file-layout.md>)
+- dsl Help recipe.import-boundary: [File](<dsl/topics/recipe.import-boundary.md>)
+- dsl Docs recipe.import-boundary: [File](<dsl/docs/recipe.import-boundary.md>)
+- dsl Help recipe.unfamiliar-area: [File](<dsl/topics/recipe.unfamiliar-area.md>)
+- dsl Docs recipe.unfamiliar-area: [File](<dsl/docs/recipe.unfamiliar-area.md>)
+- dsl Help recipe.safe-artifact-probing: [File](<dsl/topics/recipe.safe-artifact-probing.md>)
+- dsl Docs recipe.safe-artifact-probing: [File](<dsl/docs/recipe.safe-artifact-probing.md>)
 - dsl Help imports.normalize: [File](<dsl/topics/imports.normalize.md>)
 - dsl Docs imports.normalize: [File](<dsl/docs/imports.normalize.md>)
-- dsl Help inspect: [File](<dsl/topics/inspect.md>)
-- dsl Docs inspect: [File](<dsl/docs/inspect.md>)
+- dsl Help import.base: [File](<dsl/topics/import.base.md>)
+- dsl Docs import.base: [File](<dsl/docs/import.base.md>)
+- dsl Help import.rebase: [File](<dsl/topics/import.rebase.md>)
+- dsl Docs import.rebase: [File](<dsl/docs/import.rebase.md>)
+- dsl Help inspect.shared: [File](<dsl/topics/inspect.shared.md>)
+- dsl Docs inspect.shared: [File](<dsl/docs/inspect.shared.md>)
 - dsl Help inspect.file: [File](<dsl/topics/inspect.file.md>)
 - dsl Docs inspect.file: [File](<dsl/docs/inspect.file.md>)
 - dsl Help inspect.imports: [File](<dsl/topics/inspect.imports.md>)
@@ -177,6 +207,8 @@
 - dsl Docs inspect.graph: [File](<dsl/docs/inspect.graph.md>)
 - dsl Help inspect.tree: [File](<dsl/topics/inspect.tree.md>)
 - dsl Docs inspect.tree: [File](<dsl/docs/inspect.tree.md>)
+- dsl Help inspect.aliasCandidates: [File](<dsl/topics/inspect.aliasCandidates.md>)
+- dsl Docs inspect.aliasCandidates: [File](<dsl/docs/inspect.aliasCandidates.md>)
 - dsl Help inspect.duplicates: [File](<dsl/topics/inspect.duplicates.md>)
 - dsl Docs inspect.duplicates: [File](<dsl/docs/inspect.duplicates.md>)
 - dsl Help inspect.cycles: [File](<dsl/topics/inspect.cycles.md>)

package/dist/help/snippets/agents.md

@@ -10,5 +10,5 @@ Use {{docsPath}} when working with TS/JS code.
 Help fallback:
 For TS/JS code work, use aib. Start with {{docsPath}}. If local docs are not enough, run `aib help bootstrap`.
 
-Refactor-focused:
-When changing TS/JS code, use aib for semantic discovery, usages, graph, rename, move, and modulePlan. Start with {{docsPath}}.
+Refactor-focused:
+When changing TS/JS code, use aib for semantic discovery, usages, graph, and mutate DSL. Start with {{docsPath}}.

package/dist/help/tokens/qr.inline.examples.md

@@ -1,2 +1,2 @@
 Inline:
-aib qr @scripts/a.txt h=80 @scripts/b.py o=300 l=50 @logs/app.log all
+aib qr @svc/users.ts s=3:42,66:84,92 @scripts/a.txt h=80 @scripts/b.py r=300:50,500 .prettierrc all

package/dist/help/topics/basics.md

@@ -8,5 +8,5 @@ Prefer batch DSL instead of one-off inline calls.
 One request can inspect/mutate several files/entities and save reusable artifacts when supported.
 Use one-off commands only for small checks/changes.
 
-For mutations, aib asks TS/IDE refactors to update affected references and imports.
+For mutations, aib asks TypeScript semantic refactors to update affected references and imports.
 After a successful mutation, do not manually patch the same imports unless aib reports a follow-up or the build/checks show a real issue.

package/dist/help/topics/config-setup.import-normalize.md

@@ -1,18 +1,18 @@
-Configure import normalization intent.
-
-importNormalize defines default normalization rules for explicit aib imports normalize commands.
-Use it before broad or important import cleanup so the scope, target style, preferred alias, and excludes are stored in aib.json instead of repeated in command arguments.
-
-It does not run automatically during move/modulePlan.
-Use importRules for mutation-time import cleanup.
-
-Set importNormalize when the intended cleanup has project meaning:
-- adopting a new tsconfig alias across a project area;
-- converting an area to aliases;
-- converting scripts/tools or extracted modules to relative imports;
-- excluding generated or bundled output from normalization.
-
-For tiny one-file checks, inline options are fine.
+Configure import normalization intent.
+
+importNormalize defines default normalization rules for explicit aib imports normalize commands.
+Use it before broad or important import cleanup so the scope, target style, preferred alias, and excludes are stored in aib.json instead of repeated in command arguments.
+
+It does not run automatically during move/modulePlan.
+Use importRules for mutation-time import cleanup.
+
+Set importNormalize when the intended cleanup has project meaning:
+- adopting a new tsconfig alias across a project area;
+- converting an area to aliases;
+- converting scripts/tools or extracted modules to relative imports;
+- excluding generated or bundled output from normalization.
+
+For tiny one-file checks, inline options are fine.
 Before wider cleanup, put the intended rule in config and preview the smallest useful scope.
 
 Fields:
@@ -29,56 +29,56 @@ shortestAlias  rewrite to the shortest valid alias specifier
 preferAlias:
 @shared/*      prefer one alias pattern when several aliases can resolve the same file
 
-Alias cleanup:
-
-"importNormalize": [
-  {
-    "scope": "src",
-    "to": "shortestAlias",
-    "preferAlias": "@/*",
-    "exclude": [
-      "src/generated",
-      "src/**/dist"
-    ]
-  }
+Alias cleanup:
+
+"importNormalize": [
+  {
+    "scope": "src",
+    "to": "shortestAlias",
+    "preferAlias": "@/*",
+    "exclude": [
+      "src/generated",
+      "src/**/dist"
+    ]
+  }
+]
+
+Relative cleanup for scripts/tools:
+
+"importNormalize": [
+  {
+    "scope": "scripts",
+    "to": "relative",
+    "exclude": [
+      "scripts/**/*.cjs",
+      "scripts/**/*.mjs"
+    ]
+  }
 ]
 
-Relative cleanup for scripts/tools:
-
-"importNormalize": [
-  {
-    "scope": "scripts",
-    "to": "relative",
-    "exclude": [
-      "scripts/**/*.cjs",
-      "scripts/**/*.mjs"
-    ]
-  }
-]
-
-If you have not just checked config rules, run:
-
-aib config rules
-
-After editing aib.json, run:
-
-aib sync
-
-Then preview the smallest useful scope before applying:
-
-aib imports normalize preview <scope>
-
-Preview shows counts, sample import rewrites, a planId, and the apply command.
-It does not change project files.
-
-If preview changes imports outside the intended area, narrow scope or add exclude.
-
-If preview does not use the expected alias, check tsconfig aliases:
-
-aib reveal tsaliases
-
-If the config and aliases look correct but preview still looks stale or strange, run:
-
-aib sync
-
+If you have not just checked config rules, run:
+
+aib config rules
+
+After editing aib.json, run:
+
+aib sync
+
+Then preview the smallest useful scope before applying:
+
+aib imports normalize preview <scope>
+
+Preview shows counts, sample import rewrites, a planId, and the apply command.
+It does not change project files.
+
+If preview changes imports outside the intended area, narrow scope or add exclude.
+
+If preview does not use the expected alias, check tsconfig aliases:
+
+aib reveal tsaliases
+
+If the config and aliases look correct but preview still looks stale or strange, run:
+
+aib sync
+
 Then preview again.

package/dist/help/topics/config-setup.import-rules.md

@@ -7,11 +7,12 @@ Check current config:
 
 aib config rules
 
-importRules control imports created or expanded by move/modulePlan mutation cleanup.
-They do not rewrite the whole project.
-
-AIB starts from IDE/TS import preferences.
-For mutation cleanup, matching importRules in aib.json take priority.
+importRules control imports created or expanded by move/modulePlan mutation cleanup.
+They do not rewrite the whole project.
+
+A non-empty importRules block in aib.json is the complete AIB import-style authority.
+Omitted fields keep TypeScript/AIB defaults; they are not filled from editor settings.
+When importRules is empty, AIB may reuse explicit workspace-local IDE/TS preferences.
 Do not assume IDE/TS defaults match the repo style.
 
 Fields: