@automaton-labs/aib 0.0.3 → 0.0.5

package/dist/help/full.md

@@ -36,9 +36,28 @@ Use one-off commands only for small checks/changes.
 For mutations, aib asks TS/IDE 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.
 
-Working patterns
-
+Working patterns
+
+Help refresh
+
+After context compaction, always run:
+aib help help-protocol quick-map
+aib config aliases
+
+Use focused help when you would otherwise guess how a known AIB capability works.
+
+Reread bootstrap when you need to restore the overall AIB workflow faster than piecing it together from focused topics.
+If you just reread bootstrap, do not also read focused topics unless you need details that bootstrap does not cover.
+
+Do not reread bootstrap automatically if focused help is enough.
+When refreshing multiple areas, request them together instead of one by one.
+
+Example:
+aib help patterns mutation inspect inspect.file inspect.code imports.normalize
+
 Use aib before broad file reads when the question is about TS/JS structure, references, dependencies, or focused code.
+Use qr for cross-OS quick reads of text files, logs, JSON, scripts, and line windows.
+It is not a replacement for inspect.
 Use normal text search when the question is just text.
 
 For a first pass in a new codebase, map directories before reading files:
@@ -52,9 +71,9 @@ 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.
+
+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.
 
 For mutation commands, set the shell/tool harness timeout to 3 minutes.
@@ -65,15 +84,30 @@ aib execution status last
 
 This is an escape hatch for recovering the latest mutation status/result.
 
-Before repeated mutation work, check aib config:
-
-aib config
-
-Set pathAliases for repeated request paths.
-Set importRules so move/modulePlan create imports in the project style.
-
-This avoids repeating long paths in requests and avoids manual import cleanup after mutations.
-Do this before large move/modulePlan work, not after cleanup becomes repetitive.
+After reading bootstrap for the first time in a repo, run:
+
+aib config
+
+Use the output as the repo-local AIB map:
+- pathAliases show short paths to use in AIB requests;
+- importRules show how move/modulePlan should create imports;
+- importNormalize shows defaults for explicit imports normalize;
+- excludes show which noise is intentionally hidden from tree/graph/sync.
+
+If pathAliases are missing, stale, or weak for repeated paths, run:
+aib help config-setup.aliases
+
+If move/modulePlan imports do not match the repo style, run:
+aib help config-setup.import-rules
+
+If you are about to change import style across files, add or adopt tsconfig aliases, or clean imports repeatedly, run:
+aib help config-setup.import-normalize
+
+If tree/graph output includes known repo noise, run:
+aib help config-setup.excludes
+
+If sync or reveal shows too many visible TypeScript configs, run:
+aib help config-setup.tsconfigs
 
 Example aib.json config:
 
@@ -110,79 +144,35 @@ Use them to reduce input tokens for repeated inspect and mutation work.
 Aliases are for aib request paths. They do not change TypeScript imports by themselves.
 For import style after mutations, use importRules.
 
-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.
-
-Do not assume IDE/TS defaults match the repo style.
-Set importRules before large move/modulePlan work so imports do not need manual cleanup.
-
-Fields:
-scope      repo-relative file or directory scope; most specific scope wins
-specifier  relative|shortest|project-relative|non-relative
-ending     auto|minimal|index|js
-builtin    node|bare
-unusedImports  remove|preserve
-
-Defaults:
-specifier omitted      IDE/TS decides
-ending omitted         IDE/TS decides
-builtin omitted        keep TS/project builtin style
-unusedImports omitted  keep unused imports
-
-specifier:
-relative          best for local relative imports
-shortest          best for shortest valid alias/path output
-project-relative  best for root-relative project imports
-non-relative      best for package or alias imports
-
-ending:
-minimal  best for extensionless TS imports
-js       best for ESM-style TS projects that require .js
-auto     leaves the decision to TypeScript
-index    best for explicit index import style
-
-builtin:
-node        path -> node:path; best for explicit Node builtin imports
-bare        node:path -> path; best for bare Node builtin imports
-omit field  keeps TypeScript/project output; add builtin if agents keep fixing this manually
-
-unusedImports:
-remove    clean unused imports in mutation-touched files
-preserve  keep unused imports
-omit      same as preserve
-
-Mutation-touched files are files where TS produced edits: source/target files and any reference/update files TS changed.
-Recommended value: remove
-
-importNormalize defines reusable defaults for aib imports normalize.
-Use it when the same normalize request would otherwise be repeated.
-
-It affects explicit import normalize commands only.
-It does not run automatically during move/modulePlan; use importRules for mutation-time cleanup.
-
-Fields:
-scope        repo-relative file or directory scope; most specific scope wins
-to           relative|alias|shortestAlias
-preferAlias  tsconfig paths pattern used when to=alias
-exclude      files, directories, or glob-like patterns to skip
-
-to:
-relative       rewrite resolved local imports to relative paths
-alias          rewrite resolved local imports to a matching tsconfig alias
-shortestAlias  rewrite to the shortest valid alias specifier
-
-preferAlias:
-@shared/*      prefer one alias pattern when several aliases can resolve the same file
+importRules control imports created or expanded by move/modulePlan mutation cleanup.
+They do not rewrite the whole project.
 
-inspect.graph.exclude skips files before graph builds the model.
-Use it for generated files, backups, local copies, or other paths that make graph output noisy.
-
-Excluded files do not affect graph counts, hubs, entrypoints, leaves, edges, imports, importedBy, or saved graph files.
+AIB starts from IDE/TS import preferences.
+For mutation cleanup, matching importRules in aib.json take priority.
+
+Do not assume IDE/TS defaults match the repo style.
+Set importRules before large move/modulePlan work so imports do not need manual cleanup.
+
+importNormalize defines default rules for explicit aib imports normalize commands.
+
+It does not run automatically during move/modulePlan; use importRules for mutation-time cleanup.
+
+AIB has four config exclude fields:
+inspect.graph.exclude
+inspect.tree.files.exclude
+inspect.tree.onlyDirs.exclude
+sync.tsconfig.exclude
+
+For all of them, node_modules, .git, dist, build, out, and .tmp are skipped by default.
 
-Leave feedback while working.
+Use config excludes for generated files, backups, local copies, nested workspaces, seed projects, or other repository-specific noise.
+
+Graph excludes affect graph counts, hubs, entrypoints, leaves, edges, imports, importedBy, and saved graph files.
+Tree excludes affect directory/file discovery output.
+AIB syncs and watches visible tsconfigs.
+sync.tsconfig.exclude affects which TypeScript configs AIB syncs and watches.
+
+Important: leave feedback while working.
 
 aib is built for agents. Agent feedback is the main signal for improving output, docs, mutations, and token efficiency.
 
@@ -338,6 +328,10 @@ incoming references/callers      usages
 file/module connectivity         graph
 compact directory layout         tree
 repeated declarations/helpers    duplicates
+local import cycles              cycles
+
+Cycles are available but not expanded in bootstrap:
+aib help inspect.cycles
 
 Prefer one batch DSL request for related questions.
 
@@ -640,24 +634,25 @@ Inspect Tree
 Use tree to list a compact directory layout.
 It is useful before focused inspect when you know the area but not the exact file.
 
-node_modules, .git, dist, build, out, and .tmp are skipped by default.
-
 Controls:
-scope, depth, minDepth, limit, include, exclude, onlyDirs
+scope, depth, minDepth, limit, only, exclude, onlyDirs, ned, nec
 
 Specific:
 depth     max nesting depth; depth=N
 minDepth  hide shallower paths; minDepth=N
 onlyDirs  show directories only; +onlyDirs
-exclude   skip matching files/dirs
-include   only matching files/dirs; include=[...]
+only      keep only matching files/dirs; only=[...]
+exclude   skip matching files/dirs; exclude=[...]
+ned       no-default-exclude; show paths hidden by built-in excludes; +ned
+nec       no-config-exclude; ignore inspect.tree.*.exclude from aib.json; +nec
 
 Run:
 aib inspect --stdin
 
 Input:
-tree src depth=4 +onlyDirs limit=200
-tree @svc depth=3 include=["**/*.ts"] exclude=["**/*.test.ts","**/* copy.ts"]
+tree src depth=4 +onlyDirs limit=200 +ned +nec
+tree @svc depth=3 only=["**/*.ts"] exclude=["**/*.test.ts","**/* copy.ts"]
+tree src depth=3 only=["src/services/**"] limit=80
 
 Inspect Duplicates
 
@@ -691,6 +686,9 @@ Successful mutations update affected references and imports.
 
 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:
+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.
@@ -752,6 +750,9 @@ Move is semantic; it moves supported declarations and updates affected imports/r
 Use it for focused extraction into a single target file.
 For large file splitting across several target files, use modulePlan.
 
+If imports created by move do not match the repo style, run:
+aib help config-setup.import-rules
+
 Move several entities into one target:
 Run:
 aib move toFile execute --stdin
@@ -767,6 +768,9 @@ Use it when a large file should be refactored into several target files.
 
 modulePlan orchestrates semantic moves and updates affected references/imports.
 
+If imports created by modulePlan do not match the repo style, run:
+aib help config-setup.import-rules
+
 Use +expectEmpty when your modulePlan intent is to move all declarations out of the source file.
 It does not change the move behavior; it only asks output to report remaining source declarations if any remain.
 Use it only when remaining declarations would mean the split did not match your intent.
@@ -891,12 +895,16 @@ aib view aib:res_<id_2> --except ClassB.bigB --except ClassC.bigC
 
 Quick Read
 
-Use qr to read arbitrary text files with compact, cross-platform line windows.
+Use qr for cross-OS quick reads of text files: ts, js, cmd, sh, json, log, txt, ndjson, etc.
+Use it for compact line windows and batching.
 qr supports AIB path aliases.
 
-qr is not a replacement for inspect.
+It is not a replacement for inspect.
 Use it as a token-efficient way to read text data when semantic inspect is not needed.
 
+For focused text reads, prefer qr over cat/Get-Content/type, especially when aliases, line windows, or batching help.
+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
@@ -922,3 +930,9 @@ aib qr @scripts/b.py -o 300 -l 50
 aib qr @logs/app.log -a
 
 Use stdin for several reads.
+
+Need to see TypeScript configs in the repo:
+aib reveal tsconfigs
+
+Need to see TypeScript aliases across the repo:
+aib reveal tsaliases

package/dist/help/help-meta.json

@@ -1,25 +1,57 @@
 {
   "schemaVersion": 1,
   "helpVersion": "0.1.0",
-  "generatedAt": "2026-05-25T01:16:44+03:00",
-  "sourceCommit": "682a840",
-  "contentHash": "sha256:fa654cee3287525d7a9dce2fd8d4fa159138898ee4b7c8ebf6fed43bde58074a",
+  "generatedAt": "2026-05-28T14:33:23+03:00",
+  "sourceCommit": "c378ad8",
+  "contentHash": "sha256:279d19b3431e37418e85bbbbdcfce79aee5e2958098c6d95aeff5854c85b81db",
   "topics": {
     "help-format": {
       "contentHash": "sha256:771a21ea7d2818812f9cedc17183c62c74975d0d04267b015c08c086488b03d5",
       "docsHash": "sha256:cd73f5918280365c6260d7702156ae3864abc5caa2d05e5da13c689076788289"
     },
+    "help-protocol": {
+      "contentHash": "sha256:4d31b0ac5d262f8cbe0da0d883324723efa869a0a0e8edc588795872db47b885",
+      "docsHash": "sha256:acb61b3f7b1cab9fecf82042c88b90bef28922093a9372f0f6829a4f7e1653d0"
+    },
+    "quick-map": {
+      "contentHash": "sha256:522cd4651c58b08b97c8bbec7e3e452372552d4d86ae772368fa3d0922b446c4",
+      "docsHash": "sha256:6b6b5ae3ff604b3fafa5ed42638e6c8eb75bbef9b6f34e38011c9ec6fab5acb5"
+    },
     "basics": {
       "contentHash": "sha256:e9c53461377826c660b9c79b6f6b88c21c37899cf6c97e90acccc56ef8bb9ce2",
       "docsHash": "sha256:b029006c90a1809532b8de49dee9f0bb0f0fc9fd97543159a81be81a66b8a2f6"
     },
+    "first-setup": {
+      "contentHash": "sha256:ed33d8bd8c404bcd7c83a775578a284d70f1097c5270f0490de378cf5e2c4758",
+      "docsHash": "sha256:e46fb5382e626766f38baf4151c09baf340e3896242c9beac7b0670282ce7d9d"
+    },
+    "config-setup.import-rules": {
+      "contentHash": "sha256:f4825e8842a86fa7d15301bf9745ecead828d47191b3e5c390c2d9fa36fc367a",
+      "docsHash": "sha256:8a7a52ae8b93fe82ad04f6ccd03b521d1b4ce655e1152a0fd91d8a81f77c2ec5"
+    },
+    "config-setup.import-normalize": {
+      "contentHash": "sha256:55ca60276bf7d81202b88b83773d7432c3dbc130758e784ef574105058976cfc",
+      "docsHash": "sha256:ddeca97d7053c85992dad118894f56a35a79fd0a95a7558a47965102b28dfec3"
+    },
+    "config-setup.aliases": {
+      "contentHash": "sha256:15a461a8c37a0793864338f84a30614c082217dcd195a1d396c1548a05a75c8e",
+      "docsHash": "sha256:156167b9a4f633b3eb5d5ec4cb1fe1828d10e2c5d1ef9012f8cace0c41575a6a"
+    },
+    "config-setup.excludes": {
+      "contentHash": "sha256:5d790f0cd2ae6c737f22078dbba6a32cdf9ec4e69fe940079c5324b75562780c",
+      "docsHash": "sha256:61165b89254a78954f2b9a3df195e2173a224b05065be13a869ec5b630b9312a"
+    },
+    "config-setup.tsconfigs": {
+      "contentHash": "sha256:f0f1734430cc30144a0cb1ca0a9b141548e1d95f50aac94faed2babe87a7b038",
+      "docsHash": "sha256:9121c86188fc193ff597f1a8a4ed46ebda9b78dfacdb27682cc5462526db6e0f"
+    },
     "dsl": {
       "contentHash": "sha256:2256703eb851fe0c6deaed62cbfa8b7a651f42a028c25c5ee68351ae173b4c55",
       "docsHash": "sha256:c62461472e8312429d46005d5a50fa2ba449318ee652e887047df60eb6fe5a46"
     },
     "patterns": {
-      "contentHash": "sha256:0e87f84b1e2a4d75b8e7a568b07fb98054cbc48f57e9327a4a73a77d05fec0e8",
-      "docsHash": "sha256:319378d8787b4e21dc4047435e1130a44ebbfe2f8e0bc6d1628712167351478a"
+      "contentHash": "sha256:67d2534ff617252b5cde3dd4c7f29c969846b39b3a7b602b8235b2e63e8a67b0",
+      "docsHash": "sha256:4dc30610a735543d4e772772197e0b20abd658ac89104d8aeab08a9750e20285"
     },
     "session": {
       "contentHash": "sha256:c2a231e53defb09e165649d101d31a3797a3ee7a02d892b194f0c2e4805f9b4d",
@@ -34,28 +66,32 @@
       "docsHash": "sha256:3cfd022c10ad50634b4daca32ac5511146f32af3b66b632582914b106e8b9619"
     },
     "qr": {
-      "contentHash": "sha256:cefde921227b1472b14b01d9286bc7ab9fbeeaf50a6d5e76cc9bc5b966fd94ba",
-      "docsHash": "sha256:649d717f50294f74b6e633ce01039e5e92e10a8e4467d7c530c4de6be8541f6e"
+      "contentHash": "sha256:de451f914b7d8f137d4cc00d7ba04b8e348667f0dddfc254e534359420d8db7b",
+      "docsHash": "sha256:fb3fd59d272b5e59335c691092e8bb4e8eab6cdaa0296e0a64693e2d87b15668"
+    },
+    "reveal": {
+      "contentHash": "sha256:789b91ca51c7c56e95eafafa3eb736a8bc6feb70e13cb71daa37828df0d2df52",
+      "docsHash": "sha256:d44d0594ce5676ef38545f6663b81fa2b948fc0575121577f2bacd3810aee838"
     },
     "selectors": {
       "contentHash": "sha256:36ce875c11c453378e70402fd7d62ac5b6177259052fc64e603e435dd1f82eb9",
       "docsHash": "sha256:2252e2b47cd4152a821feff309d969f29a7711a875ddc99dbb565e8e477ffa52"
     },
     "mutation": {
-      "contentHash": "sha256:ce97adcbd987ee1b76cfd7823c3c36316d2c1762699ce97d879dfc0f3e214994",
-      "docsHash": "sha256:6b1f7d7e7e24b0dc0890d31c20194525cc56c7cf977c18d3c3b17def8d842ae8"
+      "contentHash": "sha256:ef5e839fd31a5e4ad52e07288015a84ce5955f65fc4b53a29524a41d5730876a",
+      "docsHash": "sha256:74f63f6848ed70f2574f5f4df2c32c54961306bd92be43a2fa58b5305fa15ef6"
     },
     "rename": {
       "contentHash": "sha256:c1a2694179915bb3a8b1fb2cedf1c61e3a3d6ed68ed262acb01705151b1c757d",
       "docsHash": "sha256:b2752a5867b51d0cfbbdd494f7a49712cc5b2f0417c6610d73b1bf5b611d8ff7"
     },
     "move": {
-      "contentHash": "sha256:4ff5efad51cf12969e04e5973fe4504d5a20fc44e648d5addd1a9e47b789d604",
-      "docsHash": "sha256:cd810b2aecc96d3034a9b9847cd04ba0528e2cb8f44dda706c75f39cda8add76"
+      "contentHash": "sha256:98f724a6f995a7c95a3619361b6ece39bede336e94ac3559be1d7fcb80422a54",
+      "docsHash": "sha256:39cae1c7bef61d1a7531c984367b5a15ae1d9e1d3f0acb9c34b12b08d78b3a35"
     },
     "modulePlan": {
-      "contentHash": "sha256:a1cde4098d483de147d0a48c64208e4b277a1f81b2e67923ff065760442ee3b3",
-      "docsHash": "sha256:e1d9f88cfe2b7b3c35f5ebc12a7613be581e4263aadb78c804b4471faedf0dfc"
+      "contentHash": "sha256:4159fc3912060b92c9d8e402efb22f830f0a2aa2cc52548cf4d19353cdfc1dbb",
+      "docsHash": "sha256:31b77f8ca94acf5a6c134a780523b5594bb4e0520a5d5844e714898cb7eae2d6"
     },
     "refactor.batch": {
       "contentHash": "sha256:9e169d6a8b45d468dae0fea26315454a0b11ee4bbb72c71a83d54c8aa38f6a75",
@@ -66,8 +102,8 @@
       "docsHash": "sha256:21f8143b5f840ded4bb124ff17106dcc5a80b9131381c09f95a86c438f95a965"
     },
     "inspect": {
-      "contentHash": "sha256:390618690d1f363596f444964ff255f525f5e418da0a6ef0f0c5b1ecb819a58b",
-      "docsHash": "sha256:219cdc77b5c30f62e394dfcf8b0f195be9bb01e6fb0b8f94bc100410b3a64182"
+      "contentHash": "sha256:10d65d517d0da8645ca9a6a13f27a160212c8a0921481e8692900c94470f6a43",
+      "docsHash": "sha256:9ca12072995fecabe132d146b214b8f4b334cb6bc670e13c806240ab130fe7e7"
     },
     "inspect.file": {
       "contentHash": "sha256:f7ca0d010d47a36258048d26ef220c1c537d99cb18443225d41ff953687a9a79",
@@ -102,12 +138,16 @@
       "docsHash": "sha256:2912898abad7c64b3e8f5669a86a70249c4d2fe742aaf3bd9b662cbaa1225a23"
     },
     "inspect.tree": {
-      "contentHash": "sha256:711eb0748f5d70258fb9f0e0eaf046e860955dfc00f4c93d705c9c04284fc31e",
-      "docsHash": "sha256:9ce8cda143b1a4952ece88a51be0cbcb36ea7e694d3d9fb3c1fba13f74588dc1"
+      "contentHash": "sha256:db064a9b7ddc8ba2530fadc7aebf214d0cf9551f2fc771b113cbd4b4511254d1",
+      "docsHash": "sha256:91c81dae81527cc7e1ddce28810540543a19487a49294402787d384c7abd4a9d"
     },
     "inspect.duplicates": {
       "contentHash": "sha256:08b6216d3c4ccd2460befec53559451b34af7157f2742b026bfe2a6babda1033",
       "docsHash": "sha256:4b57e3557cf4fdfbc7e13a1ebc1a27be2fbfd9f6d828f2807c1097f722bc5e25"
+    },
+    "inspect.cycles": {
+      "contentHash": "sha256:429bd6fa5b91e66516264ad1dab6cf09cf5446e1ea547d342f1d4abb71b94526",
+      "docsHash": "sha256:f7cc3dc73f6aa4cde94b0cc206520568b242abe16453b69f045baa20a8c37146"
     }
   }
 }

package/dist/help/index.md

@@ -4,8 +4,24 @@
 - Bootstrap: [File](<bootstrap.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 basics: [File](<topics/basics.md>)
 - Docs basics: [File](<docs/basics.md>)
+- Help first-setup: [File](<topics/first-setup.md>)
+- Docs first-setup: [File](<docs/first-setup.md>)
+- Help config-setup.import-rules: [File](<topics/config-setup.import-rules.md>)
+- Docs config-setup.import-rules: [File](<docs/config-setup.import-rules.md>)
+- Help config-setup.import-normalize: [File](<topics/config-setup.import-normalize.md>)
+- Docs config-setup.import-normalize: [File](<docs/config-setup.import-normalize.md>)
+- Help config-setup.aliases: [File](<topics/config-setup.aliases.md>)
+- Docs config-setup.aliases: [File](<docs/config-setup.aliases.md>)
+- Help config-setup.excludes: [File](<topics/config-setup.excludes.md>)
+- Docs config-setup.excludes: [File](<docs/config-setup.excludes.md>)
+- Help config-setup.tsconfigs: [File](<topics/config-setup.tsconfigs.md>)
+- Docs config-setup.tsconfigs: [File](<docs/config-setup.tsconfigs.md>)
 - Help dsl: [File](<topics/dsl.md>)
 - Docs dsl: [File](<docs/dsl.md>)
 - Help patterns: [File](<topics/patterns.md>)
@@ -18,6 +34,8 @@
 - Docs view: [File](<docs/view.md>)
 - Help qr: [File](<topics/qr.md>)
 - Docs qr: [File](<docs/qr.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>)
@@ -54,13 +72,31 @@
 - Docs inspect.tree: [File](<docs/inspect.tree.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>)
@@ -73,6 +109,8 @@
 - 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>)
@@ -109,13 +147,31 @@
 - 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 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 basics: [File](<dsl/topics/basics.md>)
 - dsl Docs basics: [File](<dsl/docs/basics.md>)
+- dsl Help first-setup: [File](<dsl/topics/first-setup.md>)
+- dsl Docs first-setup: [File](<dsl/docs/first-setup.md>)
+- dsl Help config-setup.import-rules: [File](<dsl/topics/config-setup.import-rules.md>)
+- dsl Docs config-setup.import-rules: [File](<dsl/docs/config-setup.import-rules.md>)
+- dsl Help config-setup.import-normalize: [File](<dsl/topics/config-setup.import-normalize.md>)
+- dsl Docs config-setup.import-normalize: [File](<dsl/docs/config-setup.import-normalize.md>)
+- dsl Help config-setup.aliases: [File](<dsl/topics/config-setup.aliases.md>)
+- dsl Docs config-setup.aliases: [File](<dsl/docs/config-setup.aliases.md>)
+- dsl Help config-setup.excludes: [File](<dsl/topics/config-setup.excludes.md>)
+- dsl Docs config-setup.excludes: [File](<dsl/docs/config-setup.excludes.md>)
+- dsl Help config-setup.tsconfigs: [File](<dsl/topics/config-setup.tsconfigs.md>)
+- dsl Docs config-setup.tsconfigs: [File](<dsl/docs/config-setup.tsconfigs.md>)
 - dsl Help dsl: [File](<dsl/topics/dsl.md>)
 - dsl Docs dsl: [File](<dsl/docs/dsl.md>)
 - dsl Help patterns: [File](<dsl/topics/patterns.md>)
@@ -128,6 +184,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 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>)
@@ -164,4 +222,6 @@
 - dsl Docs inspect.tree: [File](<dsl/docs/inspect.tree.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>)
+- dsl Docs inspect.cycles: [File](<dsl/docs/inspect.cycles.md>)
 - dsl Snippets agents: [File](<dsl/snippets/agents.md>)