@automaton-labs/aib 0.0.6 → 0.0.7

package/dist/help/json/topics/quick-map.md

@@ -1,28 +0,0 @@
-Read:
-  qr              quick reads: ts, js, cmd, sh, json, log, txt, etc.
-  view            hidden/truncated output
-
-Inspect:
-  file
-  imports
-  exports
-  members
-  code
-  deps
-  usages
-  graph
-  tree
-  duplicates
-  cycles
-
-Mutate:
-  rename
-  move
-  modulePlan
-  refactor batch
-  imports normalize
-
-Other:
-  config
-  prefs
-  reveal         tsconfig and tsconfig alias discovery

package/dist/help/json/topics/refactor.batch.md

@@ -1,61 +0,0 @@
-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.
-
-If a name is ambiguous, use selectors.
-Run help selectors to refresh selector syntax.
-
-refactor batch runs related mutation requests together.
-Use it when one workflow needs ordered steps, such as rename plus move.
-
-Use modulePlan when the main intent is only to split one large file into target modules.
-Use refactor batch when the split also includes coordinated renames or mixed mutation steps.
-
-refactor batch preview --stdin
-refactor batch execute --stdin
-refactor batch apply --stdin
-
-Use preview/apply when you want to inspect a large mixed plan before writing files.
-Use execute when you want to write immediately.
-Use --from with captured input handles when rerunning edited large batches.
-
-Example: rename and move in one request
-
-Run:
-aib refactor batch execute --stdin
-
-Input:
-{
-  "sourceFile": "src/service.ts",
-  "requests": [
-    {
-      "op": "rename",
-      "renames": {
-        "oldHelper": "newHelper",
-        "oldType": "newType"
-      }
-    },
-    {
-      "op": "move",
-      "targetFile": "src/service.helpers.ts",
-      "entities": ["newHelper"]
-    },
-    {
-      "op": "move",
-      "targetFile": "src/service.types.ts",
-      "entities": ["newType"]
-    }
-  ]
-}
-
-If a large or partial refactor batch fails, edit the captured input file and rerun with --from.
-For small one-off refactor requests, write a corrected request instead.
-
-Latest refactor input:
-<session-dir>/inputs/refactor/_last.json
-
-Handle:
-aib:input:refactor:last
-
-Example:
-refactor batch execute --from aib:input:refactor:last

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

@@ -1,42 +0,0 @@
-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.
-
-If a name is ambiguous, use selectors.
-Run help selectors to refresh selector syntax.
-
-Rename is for semantic symbol renames.
-It follows TypeScript references.
-It is not plain-text replacement.
-
-Single rename:
-rename preview <file> <entity> <newName>
-rename execute <file> <entity> <newName>
-rename apply <previewId>
-
-Use preview/apply when you want to inspect the planned change before writing files.
-Use execute when you want to write immediately.
-
-Run:
-aib rename execute --stdin
-
-Input:
-{
-  "file": "src/service.ts",
-  "renames": {
-    "oldName": "newName",
-    "OldService": "NewService"
-  }
-}
-
-If a large rename request fails, edit the captured input file and rerun with --from.
-For small one-off rename requests, write a corrected request instead.
-
-Latest rename input:
-<session-dir>/inputs/rename/_last.json
-
-Handle:
-aib:input:rename:last
-
-Example:
-rename preview --from aib:input:rename:last

package/dist/help/json/topics/reveal.md

@@ -1,28 +0,0 @@
-Use reveal to inspect TypeScript config discovery used by AIB.
-
-Reveal is for config/setup diagnosis.
-Use it when aliases, sync, imports normalize, or tsconfig excludes depend on which tsconfig files AIB sees.
-
-Commands:
-aib reveal tsconfigs
-aib reveal tsaliases
-
-tsconfigs shows visible TypeScript configs and config-excluded configs.
-tsaliases shows baseUrl, paths, extends, inherited paths, duplicated inherited paths, and overridden inherited paths.
-
-Controls:
-all    show all output instead of compact output
-nec    no config excludes; ignore sync.tsconfig.exclude
-ned    no default excludes
-limit  max visible groups/items before + N more
-
-Examples:
-aib reveal tsconfigs
-aib reveal tsconfigs +all
-aib reveal tsconfigs +nec limit=20
-aib reveal tsaliases
-aib reveal tsaliases +all
-aib reveal tsaliases +nec
-
-Use tsconfigs before tuning sync.tsconfig.exclude.
-Use tsaliases before creating AIB pathAliases or configuring import normalization.

package/dist/help/json/topics/selectors.md

@@ -1,21 +0,0 @@
-Selectors identify symbols when names are ambiguous.
-Use plain names when they are unambiguous.
-Use selectors when aib reports ambiguity or when different symbol kinds share a name.
-
-Example:
-type WsOptions
-class WsOptions
-
-If aib needs the exact entity, use:
-t-WsOptions
-c-WsOptions
-
-Selectors list:
-f-name  function
-c-Name  class
-i-Name  interface
-t-Name  type
-v-name  variable
-e-Name  enum
-m-name  method, usually with parent in JSON
-p-name  property, usually with parent in JSON

package/dist/help/json/topics/session.md

@@ -1,59 +0,0 @@
-Start by creating or selecting your session.
-Create it once, then reuse it.
-Do not create a new session for every command or subtask.
-
-Session stores captured inputs, saved outputs, aliases, and prefs.
-
-Prefer short session names:
-aa, tr, qa, a2
-
-Create:
-session init --name <name>
-
-Follow the command output.
-If aib says multiple sessions exist, use the session you created explicitly:
-aib -s <name> <command>
-
-Or bind this shell:
-AIB=<name>
-
-If you want to prune session inputs/outputs, use:
-session clear
-
-After clear, keep using the same session.
-
-Check:
-session status
-
-Handles:
-Commands may return handles for hidden output or reusable indexes.
-
-Hidden output:
-aib:res_<id>
-
-Use view to fetch only the hidden part without repeating the original request:
-aib view aib:res_<id>
-
-Reusable indexes:
-aib:usages:<name>
-aib:graph:<name>
-
-Usages and graph handles store computed indexes.
-Use them with --from-file to focus or expand the saved result:
-
-inspect usages --from-file aib:usages:service-usages --focus createService --detail code
-inspect graph --from-file aib:graph:services-graph --focus src/service.ts
-
-Escape hatch for latest mutation status/result:
-aib execution status last
-
-Prefs are stored in the session.
-Use prefs when you want repeated CLI behavior without repeating request fields.
-
-Set several prefs:
-session prefs set inspect.graph.hubs false inspect.graph.leaves false
-
-Show current overrides:
-session prefs get
-
-See help prefs for the full list.

package/dist/help/json/topics/view.md

@@ -1,28 +0,0 @@
-AIB keeps large outputs compact.
-When part of a result is hidden, output may include:
-
-view: aib:res_<id>
-
-Use view to fetch the hidden part without repeating what you already saw.
-
-When a batch has several hidden results of the same kind, output may include:
-
-view all code: aib:res_<id>
-view all members: aib:res_<id>
-
-A `view all` handle covers hidden parts from all results of that kind.
-
-For code views, narrow what you fetch:
-only    show only these hidden code entities
-except  show all hidden code except these entities
-
-Run:
-aib view --stdin
-
-Input:
-view aib:res_<id_1> only=[ClassA.{bigA,bigB},bigQ,ClassB.bigB]
-view aib:res_<id_2> except=[ClassC.bigC]
-
-Inline:
-aib view aib:res_<id_1> --only bigQ --only "ClassA.{bigA,bigB}"
-aib view aib:res_<id_2> --except ClassB.bigB --except ClassC.bigC