Convert opencode transcripts to otel (or agent) traces
Sync beads: Close ticket exs-out for output formats implementation
+1
+1
.beads/issues.jsonl
+1
.beads/issues.jsonl
···
4
4
{"id":"exs-8jh","title":"Add verbose logging with multiple levels","description":"Implement configurable logging with multiple verbosity levels using tracing.\n\n**Problem:**\n- No logging infrastructure\n- Cannot see detailed progress or debug information\n- No way to control output verbosity\n\n**Solution:**\nAdd tracing integration with configurable levels:\n\n```rust\n// Logging levels\n- quiet: Only critical errors\n- normal: Info and errors\n- -v: Debug, info, errors\n- -vv: Trace, debug, info, errors\n\n// Implementation\nuse tracing_subscriber::{EnvFilter, fmt};\n\nlet filter = match cli.verbose {\n 0 =\u003e \"error\",\n 1 =\u003e \"info\",\n 2 =\u003e \"debug\",\n _ =\u003e \"trace\",\n};\n\nif cli.quiet {\n let filter = \"error\";\n}\n\ntracing_subscriber::fmt()\n .with_env_filter(EnvFilter::new(filter))\n .with_writer(std::io::stderr)\n .init();\n```\n\n**Acceptance criteria:**\n- [ ] `--verbose` flag can be used multiple times (-v, -vv, -vvv)\n- [ ] `--quiet` suppresses all non-error output\n- [ ] Default logging shows info-level messages\n- [ ] Debug level shows detailed parsing progress\n- [ ] Trace level shows very detailed information\n- [ ] Log format is clean and readable\n- [ ] Log messages are useful for debugging\n\n**Implementation:**\n1. Add tracing and tracing-subscriber dependencies\n2. Create logging initialization in main()\n3. Map verbose counts to log levels\n4. Add log statements throughout parser and exporter\n5. Test with different verbosity levels","status":"open","priority":2,"issue_type":"task","created_at":"2026-02-01T18:27:00.151327488-05:00","updated_at":"2026-02-01T18:27:00.151327488-05:00"}
5
5
{"id":"exs-dsj","title":"Implement clap v4 CLI with subcommands and flags","description":"Replace basic std::env::args parsing with clap v4 derive API to provide professional CLI structure.\n\n**Problem:**\n- Current CLI uses simple std::env::args parsing\n- No subcommands (export, validate, info, watch)\n- No global flags (--verbose, --quiet, --config)\n- No help text or version display\n- No shell completions support\n\n**Solution:**\nImplement clap v4 with derive API:\n\n```rust\n#[derive(Parser)]\n#[command(name = \"exp2span\", version, author)]\npub struct Cli {\n /// Global configuration file\n #[arg(short, long, global = true, env = \"EXP2SPAN_CONFIG\")]\n pub config: Option\u003cPathBuf\u003e,\n\n /// Output format\n #[arg(short, long, global = true, value_enum)]\n pub output: OutputFormat,\n\n /// Increase logging verbosity\n #[arg(short, long, action = ArgAction::Count, global = true)]\n pub verbose: u8,\n\n /// Suppress all output\n #[arg(short, long, global = true, conflicts_with = \"verbose\")]\n pub quiet: bool,\n\n #[command(subcommand)]\n pub command: Commands,\n}\n\n#[derive(Subcommand)]\npub enum Commands {\n /// Export log to OpenTelemetry spans\n Export(ExportArgs),\n /// Validate log file format\n Validate(ValidateArgs),\n /// Show log metadata and statistics\n Info(InfoArgs),\n}\n```\n\n**Acceptance criteria:**\n- [ ] `exp2span --help` shows professional help text\n- [ ] `exp2span --version` shows version\n- [ ] `exp2span export \u003cfile\u003e` works\n- [ ] `exp2span validate \u003cfile\u003e` works\n- [ ] `exp2span info \u003cfile\u003e` works\n- [ ] `--verbose` and `--quiet` flags work globally\n- [ ] `--config` flag loads config file\n- [ ] Output format can be selected with `--output`\n\n**Implementation:**\n1. Add clap dependency with derive feature\n2. Create cli.rs module with derive structs\n3. Update main.rs to use Cli::parse()\n4. Create commands/ module with subcommand handlers\n5. Test all subcommands and flags","notes":"Implemented clap v4 CLI structure with subcommands (export, validate, info). Added global flags (--verbose, --quiet, --config, --output). Created modular structure with commands/, config/, parser/, exporter/ modules. All commands tested and working.","status":"closed","priority":2,"issue_type":"task","created_at":"2026-02-01T18:26:10.197235706-05:00","updated_at":"2026-02-01T19:02:38.84259526-05:00","closed_at":"2026-02-01T19:02:38.84259526-05:00","close_reason":"All acceptance criteria met:\n- Professional help text with subcommands and flags\n- Version display working\n- export, validate, info commands all functional\n- --verbose flag supports multiple levels (v, vv, vvv)\n- --quiet flag suppresses non-error output\n- --config and --output flags defined\n- Modular code structure created"}
6
6
{"id":"exs-njr","title":"Implement configuration file support with TOML","description":"Add layered configuration system supporting TOML files and environment variables.\n\n**Problem:**\n- No configuration support\n- Users must specify all options via CLI every time\n- Cannot set defaults for OTLP endpoint, output format, etc.\n\n**Solution:**\nImplement layered configuration (CLI \u003e ENV \u003e Config File \u003e Defaults):\n\n```toml\n# ~/.config/exp2span/config.toml or .exp2span.toml\n[otel]\nendpoint = \"http://localhost:4318\"\nheaders = { \"Authorization\" = \"Bearer ${OTEL_TOKEN}\" }\nbatch_size = 100\ntimeout_seconds = 30\n\n[output]\nformat = \"json\"\ninclude_thinking = false\ncompact = false\n\n[parser]\nstrict_mode = false\nmax_file_size_mb = 100\n```\n\n```rust\nimpl Config {\n pub async fn load(cli_path: Option\u003c\u0026Path\u003e) -\u003e Result\u003cSelf\u003e {\n let mut config = Self::default();\n\n // 1. Load from default locations\n for path in Self::default_paths() {\n if path.exists() {\n config.merge_file(\u0026path)?;\n }\n }\n\n // 2. Load from CLI-specified path\n if let Some(path) = cli_path {\n config.merge_file(path)?;\n }\n\n // 3. Apply environment variables\n config.merge_env()?;\n\n // 4. Validate final configuration\n config.validate()?;\n\n Ok(config)\n }\n\n fn default_paths() -\u003e Vec\u003cPathBuf\u003e {\n vec![\n PathBuf::from(\"/etc/exp2span/config.toml\"),\n ProjectDirs::from(\"com\", \"example\", \"exp2span\")\n .and_then(|d| d.config_dir().join(\"config.toml\"))\n .unwrap_or_default(),\n PathBuf::from(\".exp2span.toml\"),\n ]\n }\n}\n```\n\n**Acceptance criteria:**\n- [ ] Loads config from ~/.config/exp2span/config.toml\n- [ ] Loads config from .exp2span.toml in current directory\n- [ ] Environment variables override config file values\n- [ ] CLI arguments override everything\n- [ ] Missing config files are not errors\n- [ ] Invalid config shows helpful error messages\n- [ ] `--config` flag specifies custom config path\n\n**Environment variables:**\n- `EXP2SPAN_OTEL_ENDPOINT` - OTLP collector URL\n- `EXP2SPAN_OTEL_HEADERS` - OTLP auth headers\n- `EXP2SPAN_OUTPUT_FORMAT` - Output format (json, yaml, table, otlp)\n- `EXP2SPAN_CONFIG` - Custom config file path\n\n**Implementation:**\n1. Add directories, serde, toml dependencies\n2. Create config/ module with Config struct\n3. Implement file loading from multiple paths\n4. Implement environment variable parsing\n5. Add validation logic\n6. Test configuration precedence","status":"open","priority":2,"issue_type":"task","created_at":"2026-02-01T18:27:34.983363846-05:00","updated_at":"2026-02-01T18:27:34.983363846-05:00"}
7
+
{"id":"exs-out","title":"Implement output formats for span display","description":"Currently the --output flag is parsed but not implemented. Export always sends to OTLP regardless of the output format specified. Need to implement support for different output formats to display spans without exporting to OTLP.","design":"1. Add serde serialization to span representation so spans can be converted to JSON/YAML\n2. Create a formatter module with functions for each output format:\n - json: Pretty-printed JSON of all spans\n - json-lines: NDJSON (one JSON object per line)\n - yaml: YAML format\n - table: Human-readable table format\n3. Modify export.rs to check output format:\n - If output format is specified (not default), print spans to stdout\n - If default, export to OTLP as before\n - --dry-run should always print spans (not just count)\n4. Add table printing with comfy-table or similar crate","acceptance_criteria":"- `--output json` prints pretty-printed JSON of all spans to stdout\n- `--output json-lines` prints NDJSON (one span per line) to stdout\n- `--output yaml` prints YAML format to stdout\n- `--output table` prints human-readable table format to stdout\n- `--dry-run` displays spans in the specified output format instead of just counting\n- Default behavior (no --output flag) exports to OTLP as before\n- All output formats include span name, attributes, and key fields","status":"closed","priority":2,"issue_type":"task","created_at":"2026-02-01T23:05:50.182813873-05:00","updated_at":"2026-02-01T23:16:08.932913769-05:00","closed_at":"2026-02-01T23:16:08.932913769-05:00","close_reason":"Implemented all output formats: json, json-lines, yaml, table. Default now exports to OTLP, while --output flag prints spans to stdout. --dry-run now displays spans in specified format instead of just counting."}