@automaton-labs/aib 0.0.6 → 0.0.8

package/dist/help/help-index.md

@@ -0,0 +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 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-05-30T02:39:54+03:00",
-  "sourceCommit": "e42cd68",
-  "contentHash": "sha256:c1e6c894a137b4b22612357c4b35458b5ea5d4de808efb9a495c77752b599e72",
+  "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:522cd4651c58b08b97c8bbec7e3e452372552d4d86ae772368fa3d0922b446c4",
-      "docsHash": "sha256:6b6b5ae3ff604b3fafa5ed42638e6c8eb75bbef9b6f34e38011c9ec6fab5acb5"
+      "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",
@@ -46,16 +50,16 @@
       "docsHash": "sha256:9121c86188fc193ff597f1a8a4ed46ebda9b78dfacdb27682cc5462526db6e0f"
     },
     "dsl": {
-      "contentHash": "sha256:2256703eb851fe0c6deaed62cbfa8b7a651f42a028c25c5ee68351ae173b4c55",
-      "docsHash": "sha256:c62461472e8312429d46005d5a50fa2ba449318ee652e887047df60eb6fe5a46"
+      "contentHash": "sha256:82f02bf159829432c04993e05ea578ea9f40e28bb9904a41f99cccc409deaf6d",
+      "docsHash": "sha256:735401d4b8845b0d54f1151395f07fc1144b4370690ffd80f5ee40ae83a00d2c"
     },
     "patterns": {
-      "contentHash": "sha256:67d2534ff617252b5cde3dd4c7f29c969846b39b3a7b602b8235b2e63e8a67b0",
-      "docsHash": "sha256:4dc30610a735543d4e772772197e0b20abd658ac89104d8aeab08a9750e20285"
+      "contentHash": "sha256:12fd63674a32f54c988ce64e060b78ac1a6cc6caf53150e8f7448d59533d5882",
+      "docsHash": "sha256:48c04c7d0e134116a58f38453170196957747f0f33841f21a10209e41a82b21c"
     },
     "session": {
-      "contentHash": "sha256:c2a231e53defb09e165649d101d31a3797a3ee7a02d892b194f0c2e4805f9b4d",
-      "docsHash": "sha256:fd1704519e94cb546c9a269bc305a6b15027213de4ca3a7272a091de601b1e5c"
+      "contentHash": "sha256:f91f49c531f30b0590e6a711dd906b0debcc8a66dabf2999fce43612072826bb",
+      "docsHash": "sha256:ed3e807531068e43f1d11769c86bbcace94f3f72af203819273dc2ca148b6fe2"
     },
     "prefs": {
       "contentHash": "sha256:088db6ae3ec56b27a5ed6857ea8379f24628d7b33064240493e2dbff4bb3f204",
@@ -66,48 +70,88 @@
       "docsHash": "sha256:3cfd022c10ad50634b4daca32ac5511146f32af3b66b632582914b106e8b9619"
     },
     "qr": {
-      "contentHash": "sha256:de451f914b7d8f137d4cc00d7ba04b8e348667f0dddfc254e534359420d8db7b",
-      "docsHash": "sha256:fb3fd59d272b5e59335c691092e8bb4e8eab6cdaa0296e0a64693e2d87b15668"
+      "contentHash": "sha256:31ab2f8e7b30025bb4a19cda81e42056a0e900f23795834ce076933c713c8298",
+      "docsHash": "sha256:7124c6cbf2bccf5615dc197fdc2305ccfabd0f4fd31eb6d7d428167e2f7c6004"
+    },
+    "rg": {
+      "contentHash": "sha256:c91568738b7942f1586bfa698265e9886052f084a694d14d3eb3ae6282060c25",
+      "docsHash": "sha256:87336138d798100d7e16507f0e156dad06b92804cc557524d1dec0a6264ccc2e"
     },
     "reveal": {
       "contentHash": "sha256:789b91ca51c7c56e95eafafa3eb736a8bc6feb70e13cb71daa37828df0d2df52",
       "docsHash": "sha256:d44d0594ce5676ef38545f6663b81fa2b948fc0575121577f2bacd3810aee838"
     },
     "selectors": {
-      "contentHash": "sha256:36ce875c11c453378e70402fd7d62ac5b6177259052fc64e603e435dd1f82eb9",
-      "docsHash": "sha256:2252e2b47cd4152a821feff309d969f29a7711a875ddc99dbb565e8e477ffa52"
+      "contentHash": "sha256:b8897c49113766bd0762cc1f09478418f9228686acba60a853a82f63d4f4939b",
+      "docsHash": "sha256:75f83ac3defc745931e1899819456b19c0663c99b8ffd1930416716b2f029309"
     },
-    "mutation": {
-      "contentHash": "sha256:ef5e839fd31a5e4ad52e07288015a84ce5955f65fc4b53a29524a41d5730876a",
-      "docsHash": "sha256:74f63f6848ed70f2574f5f4df2c32c54961306bd92be43a2fa58b5305fa15ef6"
+    "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"
+    },
+    "moveToDir": {
+      "contentHash": "sha256:9c0e7a4e9a88a99be92c99bfa29df535b4eac6e42e2b49caeb0c2a3aab342e10",
+      "docsHash": "sha256:1ad6edcc0da41c79064256059d12309a4dcd7ec71e9d264ab495e8fa6cf429e5"
+    },
+    "renameFile": {
+      "contentHash": "sha256:f948399464164fae8c06798dc54882e263f8b8f107b1780d39f234da52753e92",
+      "docsHash": "sha256:c2b9371f2ec4e7e23c7263264753a9e5a8a37f1609be3ef4bada107d56719651"
+    },
+    "recipes": {
+      "contentHash": "sha256:45f6bde6b3b499cbf3d83dfe9736a52d189a862c0a3e3d714d387721f50e073e",
+      "docsHash": "sha256:2857ebe0e40d522261228654e24a2dd6ae041b1ac0eb9a39ee730727e3b5706d"
+    },
+    "recipe.file-layout": {
+      "contentHash": "sha256:2781f734ed162e240175e38a26ee82745232888311cf5cc9886a6b535f219271",
+      "docsHash": "sha256:533ba664b42af5afd60f6ee7c952613ac43f400cf1b8e66bdb38bb998beb385d"
     },
-    "refactor.batch": {
-      "contentHash": "sha256:9e169d6a8b45d468dae0fea26315454a0b11ee4bbb72c71a83d54c8aa38f6a75",
-      "docsHash": "sha256:e7c87c2c3851d69f3648ea421639bf8e06f8b803549abe1b6520c21bf1af01a4"
+    "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:10d65d517d0da8645ca9a6a13f27a160212c8a0921481e8692900c94470f6a43",
-      "docsHash": "sha256:9ca12072995fecabe132d146b214b8f4b334cb6bc670e13c806240ab130fe7e7"
+    "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:f7ca0d010d47a36258048d26ef220c1c537d99cb18443225d41ff953687a9a79",
-      "docsHash": "sha256:a7292898353ec1f4fc95accef0e5ce10b8803a135f8bbac4df6a49b4285b4758"
+      "contentHash": "sha256:fc8e9d2f1382da147a313c8b619592e7355575bbfdea2ff354f54bb0f1ea17bb",
+      "docsHash": "sha256:b1ef88e471b473d183ae8aab1729ee1d340110ddfb9232158029248663dac146"
     },
     "inspect.imports": {
       "contentHash": "sha256:cbd03ab54f1373727cc6f62cf4140eb081e417c3cd9705c76aabb83e42954a7e",
@@ -122,25 +166,29 @@
       "docsHash": "sha256:1157d2721c1ec09e5ee92ec5c8f94bd621ff0d4b9cbb76fbf6de22d08def22b0"
     },
     "inspect.code": {
-      "contentHash": "sha256:f2c584ff0e7251c70edee908e3f0916d8a5bb0f583d4761de0e16f9d847999fd",
-      "docsHash": "sha256:dc4b50240dadc8bd5a5781261fdc77b9d44cd77ed3e0ec9c93f05e7d2544f58e"
+      "contentHash": "sha256:10557da3f692dcdca2d00bae2ed5d72b69fa3ab753a4d766e6bbbbaf64c80d1b",
+      "docsHash": "sha256:fd05f42fb487c1fcd3dcc60485338f0de96ff9c66a017aaf4368b4725efd2470"
     },
     "inspect.deps": {
-      "contentHash": "sha256:902a40156ace923ef27e09e3793e259362d7a3a07b4c406741e4cc777655a951",
-      "docsHash": "sha256:22e4f7b230f32fd91a22ef07ba82078578a9435cb1d73ac4bd91fad124313d2a"
+      "contentHash": "sha256:d7e17ad4d37f085073a0843ecdb893de2dccfd2e9ade79ddd50670530c002fea",
+      "docsHash": "sha256:7838d535db9fb4fbd9e7d334905cceae869d3ff34688044467969cdab2b26974"
     },
     "inspect.usages": {
       "contentHash": "sha256:2f047d01e9acfbf9b51bcdb3442a8efbae0e02e1fedc1cdcf903f4b59c851921",
       "docsHash": "sha256:9b82674122c986159ca0ec82d89e4b382d0ed786b66a1cc3c9dd4f5f93bfef47"
     },
     "inspect.graph": {
-      "contentHash": "sha256:1a0257ab6e699e930a9a4f77b7b258fc29ef73b83d0352faecb06beea7db9629",
-      "docsHash": "sha256:2912898abad7c64b3e8f5669a86a70249c4d2fe742aaf3bd9b662cbaa1225a23"
+      "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"
@@ -149,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

@@ -2,12 +2,22 @@
 
 - Full: [File](<full.md>)
 - Bootstrap: [File](<bootstrap.md>)
+- Help index: [File](<help-index.md>)
+- Bootstrap pwsh: [File](<bootstrap.pwsh.md>)
+- Bootstrap bash: [File](<bootstrap.bash.md>)
+- Token qr.inline.examples.md: [File](<tokens/qr.inline.examples.md>)
+- Token stdin.examples.bash.md: [File](<tokens/stdin.examples.bash.md>)
+- Token stdin.examples.pwsh.md: [File](<tokens/stdin.examples.pwsh.md>)
+- Token stdin.examples.with-qr.bash.md: [File](<tokens/stdin.examples.with-qr.bash.md>)
+- Token stdin.examples.with-qr.pwsh.md: [File](<tokens/stdin.examples.with-qr.pwsh.md>)
 - Help help-format: [File](<topics/help-format.md>)
 - Docs help-format: [File](<docs/help-format.md>)
 - Help help-protocol: [File](<topics/help-protocol.md>)
 - 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>)
@@ -34,24 +44,44 @@
 - Docs view: [File](<docs/view.md>)
 - Help qr: [File](<topics/qr.md>)
 - Docs qr: [File](<docs/qr.md>)
+- Help rg: [File](<topics/rg.md>)
+- Docs rg: [File](<docs/rg.md>)
 - Help reveal: [File](<topics/reveal.md>)
 - 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 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>)
@@ -70,94 +100,31 @@
 - 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>)
 - Docs inspect.cycles: [File](<docs/inspect.cycles.md>)
 - Snippets agents: [File](<snippets/agents.md>)
-- json Full: [File](<json/full.md>)
-- json Bootstrap: [File](<json/bootstrap.md>)
-- json Help help-format: [File](<json/topics/help-format.md>)
-- json Docs help-format: [File](<json/docs/help-format.md>)
-- json Help help-protocol: [File](<json/topics/help-protocol.md>)
-- json Docs help-protocol: [File](<json/docs/help-protocol.md>)
-- json Help quick-map: [File](<json/topics/quick-map.md>)
-- json Docs quick-map: [File](<json/docs/quick-map.md>)
-- json Help basics: [File](<json/topics/basics.md>)
-- json Docs basics: [File](<json/docs/basics.md>)
-- json Help first-setup: [File](<json/topics/first-setup.md>)
-- json Docs first-setup: [File](<json/docs/first-setup.md>)
-- json Help config-setup.import-rules: [File](<json/topics/config-setup.import-rules.md>)
-- json Docs config-setup.import-rules: [File](<json/docs/config-setup.import-rules.md>)
-- json Help config-setup.import-normalize: [File](<json/topics/config-setup.import-normalize.md>)
-- json Docs config-setup.import-normalize: [File](<json/docs/config-setup.import-normalize.md>)
-- json Help config-setup.aliases: [File](<json/topics/config-setup.aliases.md>)
-- json Docs config-setup.aliases: [File](<json/docs/config-setup.aliases.md>)
-- json Help config-setup.excludes: [File](<json/topics/config-setup.excludes.md>)
-- json Docs config-setup.excludes: [File](<json/docs/config-setup.excludes.md>)
-- json Help config-setup.tsconfigs: [File](<json/topics/config-setup.tsconfigs.md>)
-- json Docs config-setup.tsconfigs: [File](<json/docs/config-setup.tsconfigs.md>)
-- json Help dsl: [File](<json/topics/dsl.md>)
-- json Docs dsl: [File](<json/docs/dsl.md>)
-- json Help patterns: [File](<json/topics/patterns.md>)
-- json Docs patterns: [File](<json/docs/patterns.md>)
-- json Help session: [File](<json/topics/session.md>)
-- json Docs session: [File](<json/docs/session.md>)
-- json Help prefs: [File](<json/topics/prefs.md>)
-- json Docs prefs: [File](<json/docs/prefs.md>)
-- json Help view: [File](<json/topics/view.md>)
-- json Docs view: [File](<json/docs/view.md>)
-- json Help qr: [File](<json/topics/qr.md>)
-- json Docs qr: [File](<json/docs/qr.md>)
-- json Help reveal: [File](<json/topics/reveal.md>)
-- json Docs reveal: [File](<json/docs/reveal.md>)
-- json Help selectors: [File](<json/topics/selectors.md>)
-- json Docs selectors: [File](<json/docs/selectors.md>)
-- json Help mutation: [File](<json/topics/mutation.md>)
-- json Docs mutation: [File](<json/docs/mutation.md>)
-- json Help rename: [File](<json/topics/rename.md>)
-- json Docs rename: [File](<json/docs/rename.md>)
-- json Help move: [File](<json/topics/move.md>)
-- json Docs move: [File](<json/docs/move.md>)
-- json Help modulePlan: [File](<json/topics/modulePlan.md>)
-- json Docs modulePlan: [File](<json/docs/modulePlan.md>)
-- json Help refactor.batch: [File](<json/topics/refactor.batch.md>)
-- json Docs refactor.batch: [File](<json/docs/refactor.batch.md>)
-- json Help imports.normalize: [File](<json/topics/imports.normalize.md>)
-- json Docs imports.normalize: [File](<json/docs/imports.normalize.md>)
-- json Help inspect: [File](<json/topics/inspect.md>)
-- json Docs inspect: [File](<json/docs/inspect.md>)
-- json Help inspect.file: [File](<json/topics/inspect.file.md>)
-- json Docs inspect.file: [File](<json/docs/inspect.file.md>)
-- json Help inspect.imports: [File](<json/topics/inspect.imports.md>)
-- json Docs inspect.imports: [File](<json/docs/inspect.imports.md>)
-- json Help inspect.exports: [File](<json/topics/inspect.exports.md>)
-- json Docs inspect.exports: [File](<json/docs/inspect.exports.md>)
-- json Help inspect.members: [File](<json/topics/inspect.members.md>)
-- json Docs inspect.members: [File](<json/docs/inspect.members.md>)
-- json Help inspect.code: [File](<json/topics/inspect.code.md>)
-- json Docs inspect.code: [File](<json/docs/inspect.code.md>)
-- json Help inspect.deps: [File](<json/topics/inspect.deps.md>)
-- json Docs inspect.deps: [File](<json/docs/inspect.deps.md>)
-- json Help inspect.usages: [File](<json/topics/inspect.usages.md>)
-- json Docs inspect.usages: [File](<json/docs/inspect.usages.md>)
-- json Help inspect.graph: [File](<json/topics/inspect.graph.md>)
-- json Docs inspect.graph: [File](<json/docs/inspect.graph.md>)
-- json Help inspect.tree: [File](<json/topics/inspect.tree.md>)
-- json Docs inspect.tree: [File](<json/docs/inspect.tree.md>)
-- json Help inspect.duplicates: [File](<json/topics/inspect.duplicates.md>)
-- json Docs inspect.duplicates: [File](<json/docs/inspect.duplicates.md>)
-- json Help inspect.cycles: [File](<json/topics/inspect.cycles.md>)
-- json Docs inspect.cycles: [File](<json/docs/inspect.cycles.md>)
-- json Snippets agents: [File](<json/snippets/agents.md>)
 - dsl Full: [File](<dsl/full.md>)
 - dsl Bootstrap: [File](<dsl/bootstrap.md>)
+- dsl Help index: [File](<dsl/help-index.md>)
+- dsl Bootstrap pwsh: [File](<dsl/bootstrap.pwsh.md>)
+- dsl Bootstrap bash: [File](<dsl/bootstrap.bash.md>)
+- dsl Token qr.inline.examples.md: [File](<dsl/tokens/qr.inline.examples.md>)
+- dsl Token stdin.examples.bash.md: [File](<dsl/tokens/stdin.examples.bash.md>)
+- dsl Token stdin.examples.pwsh.md: [File](<dsl/tokens/stdin.examples.pwsh.md>)
+- dsl Token stdin.examples.with-qr.bash.md: [File](<dsl/tokens/stdin.examples.with-qr.bash.md>)
+- dsl Token stdin.examples.with-qr.pwsh.md: [File](<dsl/tokens/stdin.examples.with-qr.pwsh.md>)
 - dsl Help help-format: [File](<dsl/topics/help-format.md>)
 - dsl Docs help-format: [File](<dsl/docs/help-format.md>)
 - dsl Help help-protocol: [File](<dsl/topics/help-protocol.md>)
 - 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>)
@@ -184,24 +151,44 @@
 - dsl Docs view: [File](<dsl/docs/view.md>)
 - dsl Help qr: [File](<dsl/topics/qr.md>)
 - dsl Docs qr: [File](<dsl/docs/qr.md>)
+- dsl Help rg: [File](<dsl/topics/rg.md>)
+- dsl Docs rg: [File](<dsl/docs/rg.md>)
 - dsl Help reveal: [File](<dsl/topics/reveal.md>)
 - 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 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>)
@@ -220,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

@@ -0,0 +1,2 @@
+Inline:
+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/tokens/stdin.examples.bash.md

@@ -0,0 +1,8 @@
+Bash/Zsh:
+aib <command> --stdin <<'EOF'
+<input>
+EOF
+
+aib inspect --stdin <<'EOF'
+tree . +onlyDirs limit=20
+EOF

package/dist/help/tokens/stdin.examples.pwsh.md

@@ -0,0 +1,8 @@
+PowerShell:
+@'
+<input>
+'@ | aib <command> --stdin
+
+@'
+tree . +onlyDirs limit=20
+'@ | aib inspect --stdin

package/dist/help/tokens/stdin.examples.with-qr.bash.md

@@ -0,0 +1,12 @@
+Bash/Zsh:
+aib <command> --stdin <<'EOF'
+<input>
+EOF
+
+aib inspect --stdin <<'EOF'
+tree . +onlyDirs limit=20
+EOF
+
+aib qr --stdin <<'EOF'
+qr package.json h=20
+EOF

package/dist/help/tokens/stdin.examples.with-qr.pwsh.md

@@ -0,0 +1,12 @@
+PowerShell:
+@'
+<input>
+'@ | aib <command> --stdin
+
+@'
+tree . +onlyDirs limit=20
+'@ | aib inspect --stdin
+
+@'
+qr package.json h=20
+'@ | aib qr --stdin

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.