@automaton-labs/aib 0.0.6 → 0.0.7

package/dist/help/help-meta.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": 1,
   "helpVersion": "0.1.0",
-  "generatedAt": "2026-05-30T02:39:54+03:00",
-  "sourceCommit": "e42cd68",
-  "contentHash": "sha256:c1e6c894a137b4b22612357c4b35458b5ea5d4de808efb9a495c77752b599e72",
+  "generatedAt": "2026-06-11T13:27:23+03:00",
+  "sourceCommit": "f3bddf34",
+  "contentHash": "sha256:3d73b26f64e061560b920add21f1ff74187b93f8adab6044c69a6d2ae436e534",
   "topics": {
     "help-format": {
       "contentHash": "sha256:b1a0a6ca2a5ac2e61285854e8dd3c951a329073f139ccca50ebe519c2ca0484e",
@@ -14,8 +14,8 @@
       "docsHash": "sha256:acb61b3f7b1cab9fecf82042c88b90bef28922093a9372f0f6829a4f7e1653d0"
     },
     "quick-map": {
-      "contentHash": "sha256:522cd4651c58b08b97c8bbec7e3e452372552d4d86ae772368fa3d0922b446c4",
-      "docsHash": "sha256:6b6b5ae3ff604b3fafa5ed42638e6c8eb75bbef9b6f34e38011c9ec6fab5acb5"
+      "contentHash": "sha256:54ccf688bacd8d37841070bb3a3330d17db1a109757612ca6a953530906db81c",
+      "docsHash": "sha256:10b48450656617df4e0efe51d1b89330f1d5c5cd9fdf9ab90feecec6cea52065"
     },
     "basics": {
       "contentHash": "sha256:e9c53461377826c660b9c79b6f6b88c21c37899cf6c97e90acccc56ef8bb9ce2",
@@ -46,16 +46,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:2725e71c1162cd8db8ec0847bf050cc005b582878a3a170601780399b8cf115d",
+      "docsHash": "sha256:f93ff64ba4cbe34c001ac36b6f6208a05a31e0e9040ee46bcc0cfc0f0044b58f"
     },
     "session": {
-      "contentHash": "sha256:c2a231e53defb09e165649d101d31a3797a3ee7a02d892b194f0c2e4805f9b4d",
-      "docsHash": "sha256:fd1704519e94cb546c9a269bc305a6b15027213de4ca3a7272a091de601b1e5c"
+      "contentHash": "sha256:f91f49c531f30b0590e6a711dd906b0debcc8a66dabf2999fce43612072826bb",
+      "docsHash": "sha256:ed3e807531068e43f1d11769c86bbcace94f3f72af203819273dc2ca148b6fe2"
     },
     "prefs": {
       "contentHash": "sha256:088db6ae3ec56b27a5ed6857ea8379f24628d7b33064240493e2dbff4bb3f204",
@@ -66,20 +66,24 @@
       "docsHash": "sha256:3cfd022c10ad50634b4daca32ac5511146f32af3b66b632582914b106e8b9619"
     },
     "qr": {
-      "contentHash": "sha256:de451f914b7d8f137d4cc00d7ba04b8e348667f0dddfc254e534359420d8db7b",
-      "docsHash": "sha256:fb3fd59d272b5e59335c691092e8bb4e8eab6cdaa0296e0a64693e2d87b15668"
+      "contentHash": "sha256:700050d6a62553e12c35c8acb9e4b47471feeef82bb61a7612e953e81f0eb5bd",
+      "docsHash": "sha256:a0b5d09f2c8b191bfc161402bda58820e93a302048a3c43aedb52281dc1fb020"
+    },
+    "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"
+      "contentHash": "sha256:c46b878b05eec0db95664c148e2c2b82a1bc541ee843cecdfc4fbe0a24bdab2a",
+      "docsHash": "sha256:239e932b33bda72f6d6b37b53aaa9e4fcd5cd1cc09c5f0ef5633262781e1859c"
     },
     "rename": {
       "contentHash": "sha256:c1a2694179915bb3a8b1fb2cedf1c61e3a3d6ed68ed262acb01705151b1c757d",
@@ -97,17 +101,29 @@
       "contentHash": "sha256:9e169d6a8b45d468dae0fea26315454a0b11ee4bbb72c71a83d54c8aa38f6a75",
       "docsHash": "sha256:e7c87c2c3851d69f3648ea421639bf8e06f8b803549abe1b6520c21bf1af01a4"
     },
+    "file.move": {
+      "contentHash": "sha256:be35bc1795afd46035be9783203949e7f706171b9c624c0143ad4e9fa30801b4",
+      "docsHash": "sha256:05eab7aef652576651946c93b0d13966f560aea70921991f7b75001844deb101"
+    },
+    "file.rename": {
+      "contentHash": "sha256:7fef39e4e0cabf29353b8482879e5b02d4734d7cac16feba93f3a2dd8743d6bd",
+      "docsHash": "sha256:41800cf762cf08589854772cac0b4919f81e153fd0c7e5747dd8c07e309d424a"
+    },
+    "recipe.file-layout": {
+      "contentHash": "sha256:c0c5986a60fd49b1db6948b90b51adbe417df4b82cc96d6ed91d1ef06fde66d4",
+      "docsHash": "sha256:07362762cf88857745380c14989e69565d6f06bc5fdb12bf79169e1875c2e325"
+    },
     "imports.normalize": {
       "contentHash": "sha256:e0f3e6720307cfff1b68db1a6125e222f9798f1e29c5bcec3aab069acf1ba940",
       "docsHash": "sha256:21f8143b5f840ded4bb124ff17106dcc5a80b9131381c09f95a86c438f95a965"
     },
     "inspect": {
-      "contentHash": "sha256:10d65d517d0da8645ca9a6a13f27a160212c8a0921481e8692900c94470f6a43",
-      "docsHash": "sha256:9ca12072995fecabe132d146b214b8f4b334cb6bc670e13c806240ab130fe7e7"
+      "contentHash": "sha256:b6726ec8dd39f75c5a83f0026bf2d354e3da6b38a60cf404f65a4ca690c48f66",
+      "docsHash": "sha256:53b027f1444d3386d6d952ed1ecec10ae67fdfd2ca22b657411990703e00da18"
     },
     "inspect.file": {
-      "contentHash": "sha256:f7ca0d010d47a36258048d26ef220c1c537d99cb18443225d41ff953687a9a79",
-      "docsHash": "sha256:a7292898353ec1f4fc95accef0e5ce10b8803a135f8bbac4df6a49b4285b4758"
+      "contentHash": "sha256:837462936cbe9190275e86eb80553a92d18a562b72257cb6dea26e651d7d4f31",
+      "docsHash": "sha256:bfbcad0c5b1e23be01795b57a94fe9118480b85d6e30dcc0e5c9368e3098de88"
     },
     "inspect.imports": {
       "contentHash": "sha256:cbd03ab54f1373727cc6f62cf4140eb081e417c3cd9705c76aabb83e42954a7e",
@@ -122,20 +138,20 @@
       "docsHash": "sha256:1157d2721c1ec09e5ee92ec5c8f94bd621ff0d4b9cbb76fbf6de22d08def22b0"
     },
     "inspect.code": {
-      "contentHash": "sha256:f2c584ff0e7251c70edee908e3f0916d8a5bb0f583d4761de0e16f9d847999fd",
-      "docsHash": "sha256:dc4b50240dadc8bd5a5781261fdc77b9d44cd77ed3e0ec9c93f05e7d2544f58e"
+      "contentHash": "sha256:5d171649777387b0ed0b32d8638406be2c06748956d14edd5c3281a5f418ec6e",
+      "docsHash": "sha256:eff10029d356db3e7fcf22726a19223fb07f01bb340b4b281f9a56cbaa2e3b5a"
     },
     "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:a7d4792c063f8244b84579c9dc5a847755653092a9026010c87bfa0bbbafdd60",
+      "docsHash": "sha256:2bda09bfcec9645bb2227fb8fca8f03a02a78c6b94118ab2ad5bd1e946d33c3f"
     },
     "inspect.tree": {
       "contentHash": "sha256:db064a9b7ddc8ba2530fadc7aebf214d0cf9551f2fc771b113cbd4b4511254d1",

package/dist/help/index.md

@@ -2,6 +2,14 @@
 
 - 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>)
@@ -34,6 +42,8 @@
 - 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>)
@@ -48,6 +58,12 @@
 - 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 recipe.file-layout: [File](<topics/recipe.file-layout.md>)
+- Docs recipe.file-layout: [File](<docs/recipe.file-layout.md>)
 - Help imports.normalize: [File](<topics/imports.normalize.md>)
 - Docs imports.normalize: [File](<docs/imports.normalize.md>)
 - Help inspect: [File](<topics/inspect.md>)
@@ -75,83 +91,16 @@
 - 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>)
@@ -184,6 +133,8 @@
 - 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>)
@@ -198,6 +149,12 @@
 - 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 recipe.file-layout: [File](<dsl/topics/recipe.file-layout.md>)
+- dsl Docs recipe.file-layout: [File](<dsl/docs/recipe.file-layout.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>)

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

@@ -0,0 +1,2 @@
+Inline:
+aib qr @scripts/a.txt h=80 @scripts/b.py o=300 l=50 @logs/app.log 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/dsl.md

@@ -8,9 +8,10 @@ DSL request model:
 - For one-off file operations, pass the path directly.
 
 Syntax:
-@file <path>               default file
-@source <path>             default sourceFile for mutations
-op arg arg key=value       request
+@file <path>               default file
+@source <path>             default sourceFile for mutations
+@base <dir>                default base dir for file mutations
+op arg arg key=value       request
 +flag                      boolean true
 -flag                      boolean false
 >name                      save reusable artifact when supported

package/dist/help/topics/file.move.md

@@ -0,0 +1,44 @@
+Modes: preview/apply or execute.
+Use execute for routine changes.
+Use preview/apply when learning a mutation command or inspecting a large multi-step request before writing files.
+
+file move moves whole files into target directories.
+Missing target directories are created automatically.
+
+Use it when the filesystem layout is the intent.
+
+Move to directory:
+file move toDir preview --stdin
+file move toDir execute --stdin
+file move toDir apply <previewId>
+
+Use preview/apply when you want to inspect planned file moves before writing files.
+Use execute when you want to write immediately.
+
+Run:
+aib file move toDir execute --stdin
+
+Input:
+@base src/svc
+moveToDir facade: ../services/fileA.ts fileB.ts
+moveToDir ../core/services: fileC.ts classes/main/fileD.ts
+
+How this resolves:
+../services/fileA.ts resolves to src/services/fileA.ts
+fileB.ts resolves to src/svc/fileB.ts
+facade resolves to src/svc/facade
+../core/services resolves to src/core/services
+moved files keep their basename, not their source subdirectory
+
+Resulting files:
+src/svc/facade/fileA.ts
+src/svc/facade/fileB.ts
+src/core/services/fileC.ts
+src/core/services/fileD.ts
+
+Rules:
+- @base sets the base directory for source files and target directories.
+- source file paths resolve from @base; cwd-relative paths are accepted when the @base path does not exist.
+- target directories resolve from @base.
+- source paths and target directories may use `..`.
+- file move supports files, not directories.

package/dist/help/topics/file.rename.md

@@ -0,0 +1,33 @@
+Modes: preview/apply or execute.
+Use execute for routine changes.
+Use preview/apply when learning a mutation command or inspecting a large multi-step request before writing files.
+
+file rename renames whole files.
+
+Rename files:
+file rename preview --stdin
+file rename execute --stdin
+file rename apply <previewId>
+
+Use preview/apply when you want to inspect planned file renames before writing files.
+Use execute when you want to write immediately.
+
+Run:
+aib file rename execute --stdin
+
+Input:
+@base src
+rename svc/ws-cli.ts->cli.ts svc/ws-command.ts->command.ts
+rename svc/core/opt-build.ts->builder.ts
+
+How this resolves:
+- source files resolve from @base;
+- target names without a directory stay beside each source file.
+
+Rules:
+- @base sets the base directory for source files.
+- source file paths resolve from @base; cwd-relative paths are accepted when the @base path does not exist.
+- target names without a directory stay beside each source file.
+- target paths with a directory resolve from @base.
+- source paths and target paths may use `..`.
+- file rename supports files, not directories.

package/dist/help/topics/inspect.code.md

@@ -2,7 +2,7 @@ Use code to fetch exact declarations or members.
 It returns focused code without reading the whole file.
 
 Good for:
-- reading a known function, class, method, or declaration
+- reading a known function, class, method, declaration, `default`, or `IIFE#N`
 - fetching several related code blocks in one request
 - keeping context focused on code needed for the current task
 
@@ -19,9 +19,9 @@ Use -ranges for source without ranges.
 Prefs:
 inspect.code.maxNonEmptyLines
 
-Run:
-aib inspect --stdin
-
+Run:
+aib inspect --stdin
+
 Input:
 code @svc/service.ts Service.{render,reset} normalize
-code @svc/serviceB.ts ServiceB.{constructor}
+code @svc/serviceB.ts ServiceB.{constructor} default IIFE#1

package/dist/help/topics/inspect.deps.md

@@ -1,18 +1,18 @@
 Use deps to see what one entity depends on inside its file.
 It separates type-only dependencies from runtime value dependencies.
 
-Good for:
-- checking what a symbol may need when moved or extracted
-- spotting nearby types, constants, or helpers tied to one entity
-- deciding whether one symbol is standalone or tied to nearby declarations
+Good for:
+- checking what a symbol may need when moved or extracted
+- spotting nearby types, constants, or helpers tied to one entity
+- deciding whether one symbol is standalone or tied to nearby declarations
 - debugging mutation failures caused by local dependency shape
 
 Controls:
 file, entity, entities, parent
 
-Run:
-aib inspect --stdin
-
+Run:
+aib inspect --stdin
+
 Input:
 deps @svc/service.ts entities=[createService,normalize,Service.{render,reset}]
 deps @svc/serviceB.ts ServiceB.{constructor} getConfig

package/dist/help/topics/inspect.file.md

@@ -3,8 +3,9 @@ Exported declarations are marked in the output.
 It shows what lives in the file before you decide whether to read code.
 
 Good for:
-- mapping an unfamiliar file
+- mapping a file
 - listing top-level declarations
+- seeing default exports, decorators, IIFEs, and runtime calls
 - checking whether a file contains real declarations or mostly re-exports
 
 Do not add limit just in case.

package/dist/help/topics/inspect.graph.md

@@ -35,7 +35,7 @@ scope=src creates a broad reusable map for src.
 scope=src/services is cheaper for local work.
 scope=[src/services,src/components] compares known areas without mapping all src.
 
-After you understand which graph sections matter, hide the rest with flags or prefs.
+After you understand which graph sections matter, hide the rest with flags.
 Graph can be noisy; shape it for the current task.
 
 Controls:
@@ -59,8 +59,8 @@ graph from=aib:graph:services-graph focus=[@svc/users.ts,@svc/admins.ts] +symbol
 Focus saved graph later:
 inspect graph --from-file aib:graph:services-graph --focus @svc/messages.ts --focus @svc/posts.ts --symbol-usage
 
-Inline graph focus can add focus and symbolUsage.
-Use DSL, request files, or prefs to hide sections such as edges/hubs/entrypoints/leaves.
+Inline graph focus can add focus and symbolUsage.
+Use DSL or request flags to hide sections such as edges/hubs/entrypoints/leaves.
 
 Specialized graph command:
 Run:

package/dist/help/topics/inspect.md

@@ -26,16 +26,16 @@ local import cycles              cycles
 Prefer one batch DSL request for related questions.
 
 Batch example:
-
-Run:
-aib inspect --stdin
-
+
+Run:
+aib inspect --stdin
+
 Input:
 @file @svc/service.ts
 file
 file @svc/serviceB.ts
 members Service
-code entities=[Service.{render,reset},normalize]
+code entities=[Service.{render,reset},normalize,default,IIFE#1]
 code @svc/serviceC.ts ServiceC -ranges
 usages target=@svc/service.ts normalize scope=src detail=loc
 duplicates scope=src/scripts detail=sum limit=20

package/dist/help/topics/mutation.md

@@ -1,19 +1,29 @@
-Mutation commands change code through TS/IDE refactors.
-Successful mutations update affected references and imports.
-
+Mutation commands change code and files through TS/IDE-backed operations.
+Successful mutations update affected references and imports.
+
+Semantic mutations change TypeScript symbols/declarations.
+File mutations change file layout.
+
 After a successful mutation, do not manually patch the same imports unless aib reports a follow-up or checks show a real issue.
 
-If move/modulePlan imports do not match the repo style, run:
+If mutation imports do not match the repo style, run:
 aib help config-setup.import-rules
 
-AIB mutations are designed to reduce manual checking.
-Your job is to express the intent in DSL.
-AIB's job is to convert that intent into code changes.
-
-Do not read all changed files just because a mutation touched them.
-That defeats the purpose of using AIB for mechanical refactors.
-
-If the command succeeds, the requested mechanical change was applied.
+AIB mutations are designed to reduce manual checking.
+Your job is to express the intent in DSL.
+AIB's job is to convert that intent into code changes.
+
+Choose the mutation by intent:
+rename - rename TypeScript symbols
+move toFile - move TypeScript declarations into one file
+modulePlan - split one source file into several modules
+file move toDir - move whole files into directories
+file rename - rename whole files.
+
+Do not read all changed files just because a mutation touched them.
+That defeats the purpose of using AIB for mechanical refactors.
+
+If the command succeeds, the requested mechanical change was applied.
 After failure or partial success, use the output to decide the next request.
 
 When running mutation commands, set the harness timeout to 3 minutes.
@@ -26,7 +36,7 @@ preview  inspect planned edits, then apply by id
 apply    write a previewed change
 execute  write immediately
 
-Use execute for routine rename/move/modulePlan requests.
+Use execute for routine requests.
 
 Use preview/apply when you are learning a mutation command, or when one request contains a large multi-step change that you want to inspect before writing files.
 Typical examples: a huge modulePlan or refactor batch.

package/dist/help/topics/patterns.md

@@ -8,7 +8,7 @@ Use normal text search when the question is just text.
 
 For a first pass in a new codebase, map directories before reading files:
 
-tree src depth=5 +onlyDirs limit=200
+aib inspect tree src --depth 5 --only-dirs --limit 200
 
 Start compact for broad scans.
 Use summary, locations, or local graph views first when output could be large.
@@ -18,10 +18,6 @@ If output hides data and shows `view: aib:res_<id>`, use `aib view ...` to fetch
 Compact output is a starting point, not a substitute for needed code.
 Fetch exact code when correctness depends on implementation details.
 
-Use prefs when the current phase repeats the same output shape.
-Turn details off when they stop helping.
-Turn them back on when they matter.
-
 Use @file only when several following operations share the same file.
 For independent one-off file requests, pass the path directly:
 file @svc/a.ts

package/dist/help/topics/qr.md

@@ -9,27 +9,12 @@ For focused text reads, prefer qr over cat/Get-Content/type, especially when ali
 Use shell reads only when piping into shell tooling or qr is unavailable.
 
 Controls:
--h N    head; first N lines
--t N    tail; last N lines
--o N    offset; starting line, 1-based
--l N    limit; line count for offset reads
--a      all; whole file
+h=N        head; first N lines
+t=N        tail; last N lines
+o=N l=N    range; starting line and line count
+all        whole file
 
-If no window is provided, qr uses -h 80.
-If -a is present, it wins over other window flags.
+If no window is provided, qr uses h=80.
+If all is present, it wins over other window flags.
 
-Run:
-aib qr --stdin
-
-Input:
-qr @scripts/a.txt h=80
-qr @scripts/b.py o=300 l=50
-qr @scripts/c.md t=120
-qr @logs/app.log all
-
-Inline:
-aib qr @scripts/a.txt -h 80
-aib qr @scripts/b.py -o 300 -l 50
-aib qr @logs/app.log -a
-
-Use stdin for several reads.
+{{qr.inline.examples}}