@sleds/cli 0.1.64 → 0.1.65

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +20 -0
  2. package/dist/sleds.mjs +1132 -58
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -95,6 +95,26 @@ The flags `sleds route run` and `sleds engine` share:
95
95
 
96
96
  `sleds engine log [--name <n>] [--org <slug>] [--lines N] [--json]` prints the last N lines (default 200) of the log an installed engine's launchd agent writes (`<name>.log` beside its state file, in its org's directory). `--json` is `{v, engine, path, exists, lines}` — what the menu bar polls, so it never reads the path itself; an engine never installed is `exists: false`, not an error.
97
97
 
98
+ ## Archiving a Sleuth.io org
99
+
100
+ Sleuth.io closes at the end of 2026; its deploy history goes with it unless it is exported first.
101
+
102
+ ```
103
+ SLEUTH_API_KEY=… sleds sleuth export --org gigpro --out ~/sleuth-export
104
+ ```
105
+
106
+ ```
107
+ sleuth-export/
108
+ manifest.json what was written, each count beside Sleuth's own, fields Sleuth refused
109
+ schema.json the API's schema on the day (introspection), to read the archive by
110
+ organization.json
111
+ deploys/2022-01.jsonl … every change (deploy), one JSON object a line, a file a month
112
+ projects.jsonl deployments.jsonl environments.jsonl teams.jsonl labels.jsonl impactSources.jsonl
113
+ incidents/2022-01.jsonl … flagEvents/… when the schema has them
114
+ ```
115
+
116
+ Nested items carry `_parents` (the project and organization they came from). The exporter reads Sleuth's schema and builds every query from it, so a field Sleuth renames or drops is followed, not a crash. Re-run the same command to resume after a stop: finished past months are skipped (`--fresh` fetches them again). `--since`/`--until YYYY-MM`, `--only deploys,projects`, `--page-size`, `--depth`; `sleds sleuth` lists them all. The command exits 1 when a section is incomplete, and the manifest says which.
117
+
98
118
  ## Docs
99
119
 
100
120
  Repo: github.com/spdyadam/sleds · Site: sleds.ai