@devosurf/tesser 0.1.0-alpha.3 → 0.1.0-alpha.4

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 (19) hide show
  1. package/README.md +15 -7
  2. package/dist/index.js +830 -220
  3. package/dist/index.js.map +4 -4
  4. package/package.json +3 -3
  5. package/src/commands/doctor.test.ts +39 -0
  6. package/src/commands/doctor.ts +117 -0
  7. package/src/commands/init.test.ts +14 -1
  8. package/src/commands/init.ts +10 -4
  9. package/src/commands/project-docs.ts +6 -2
  10. package/src/completion.test.ts +14 -0
  11. package/src/completion.ts +92 -0
  12. package/src/index.ts +220 -57
  13. package/src/inputs.test.ts +21 -0
  14. package/src/inputs.ts +64 -0
  15. package/src/login.test.ts +19 -1
  16. package/src/login.ts +92 -1
  17. package/src/output.ts +15 -3
  18. package/src/schema.test.ts +26 -0
  19. package/src/schema.ts +289 -0
package/README.md CHANGED
@@ -1,15 +1,19 @@
1
1
  # @devosurf/tesser (`tesser`)
2
2
 
3
3
  The interface both your agent and you drive everything through. Machine-first (ADR-0007):
4
- `--json` on every command (stdout = one JSON document, stderr = logs), a deterministic
5
- [exit-code taxonomy](../../docs/EXIT-CODES.md). CLI-first; MCP deferred.
4
+ `--output json` / `--json` on every command (stdout = one JSON document, stderr = logs),
5
+ a deterministic [exit-code taxonomy](../../docs/EXIT-CODES.md), plus `tesser schema`
6
+ for machine-readable command discovery. CLI-first; MCP deferred.
6
7
 
7
8
  > Status: **implemented.**
8
9
 
9
10
  ```
10
- # auth & link (agent lane: set TESSER_TOKEN and skip all prompts)
11
- tesser login --url URL --token tsk_… # verify + store a profile
12
- tesser init <name> # scaffold a Project (one repo of automations)
11
+ # auth & link (agent lane: set TESSER_TOKEN or use --token-stdin; humans can run tesser login and be prompted)
12
+ printf '%s' "$TESSER_TOKEN" | tesser login --url URL --token-stdin # verify + store a profile
13
+ tesser schema # machine-readable CLI contract, no auth needed
14
+ tesser doctor # local/project/auth preflight for agents
15
+ tesser completion bash|zsh # shell completion script
16
+ tesser init <name> [--force] # scaffold a Project (one repo of automations)
13
17
  tesser upgrade # pin Tesser packages to this CLI version + refresh .tesser/docs
14
18
  tesser link [--repo URL] # register the Project on the instance
15
19
  tesser status # instance health + deploy state
@@ -29,11 +33,15 @@ tesser rollback <automation> --to <version> # instant alias re-point, no r
29
33
  # secrets & runs (the agent never sees values)
30
34
  tesser secrets list | rm <name>
31
35
  printenv MY_SECRET | tesser secrets set <name> --value-stdin # human/CI lane; never argv
32
- tesser runs list|show|trigger|signal|cancel
33
- tesser logs <runId> [--follow]
36
+ tesser runs list [--limit N] [--offset N] [--fields id,status]
37
+ tesser runs trigger <automation> --input-file -
38
+ tesser runs signal <runId> <name> --payload-file -
39
+ tesser logs <runId> [--follow] [--limit N] [--offset N] [-o ndjson]
40
+ tesser harness connect claude-code --connect CONNECT_URL # preferred Harness auth namespace
34
41
  ```
35
42
 
36
43
  Auth resolution: `--token` > `TESSER_TOKEN` > profile (`~/.config/tesser/config.json`).
44
+ For `tesser login`, prefer `--token-stdin`; `--token` remains for compatibility but can leak via argv.
37
45
  Instance resolution: `--url` > `tesser.json` > `TESSER_URL` > profile > `http://localhost:8377`.
38
46
 
39
47
  `init` pins all Tesser packages to the CLI's exact version and writes committed agent reference docs under `.tesser/docs/` plus a user-editable `AGENTS.md`. During alpha/beta, upgrade with the target CLI version so package pins and docs move together: `npx @devosurf/tesser@<version> upgrade`.