CHANGELOG.md

Changelog

0.9.0

Enhancements

• Automatically bootstrap Cog install via environment variables #811
• Add operable:user command #147
• Add operable:chat-handles command #787
• Add list, info, and versions subcommands to operable:bundle chat command #776
• Redesign operable:permissions and operable:role command #675, #678
• Cache Relay for a given bundle during pipeline execution #777
• Improve Relay's command encoding scheme #837
• Unify chat naming conventions #681
• Reserve "cog" bundle name for future use #817

Bug Fixes

• Remove single trailing newline from template source #835
• Prevent revoking cog-admin role from the cog-admin group #795
• Relay bundle catalog diff misses removed bundles #791
• Clean up pre-bundle versions database tables #783

0.8.0

Enhancements

• Added operable:trigger chat command #771
• cogctl can read config.yaml from stdin #773
• Incident Response workflow #698
• Added support for configurable container memory in Relay docs

Command bundles

• pagerduty NEW
  • Repo: cogcmd/pagerduty
• pingdom NEW
  • Repo: cogcmd/pingdom

Bug Fixes

• Multi commands run slowly #677
  • Optimized Relay's Docker integration:
    • Containers are cached and reused for the duration of a command pipeline. Doing so reduces worst case Docker container creation from O(N * I * R) to O(N * R) where N is the number of pipeline stages, I is the number of command invocations per stage, and R is the number of Relays able to run the command.
    • Implemented a custom streaming interface on top of Docker's hijacked connection API further reducing the number of Docker API calls required per command invocation.
  • Internal testing has shown these optimizations reduce execution times for Docker-based commands by 50 - 70%.
• Fix Relay's JSON handling: Don't coerce large integers into scientific notation #768
• HipChat can't execute Relay-mediated commands #770

v0.7.5

Enhancements

• First release of cog-rb: Ruby Cog command development library
• First release of pycog3: Python3 Cog command development library

Command bundles

• circle NEW
  • Repo: cogcmd/circle
• format NEW
  • Repo: cogcmd/format
  • Docker image: cogcmd/format
• statuspage NEW
  • Repo: cogcmd/statuspage
  • Docker image: cogcmd/statuspage
• twitter bundle NEW
  • Repo: cogcmd/twitter
  • Docker image: cogcmd/twitter

Bug Fixes

• Command pipeline executor crashes when failing to authorized against a rule mentioning multiple permissions #758
• go-relay doesn't respect documented calling convention #765

v0.7.0

Enhancements

• Command Bundle Versioning w/upgrade and downgrade support #635,#636, #637, #638, #642, #644, #657, #706
• Redesigned UX of 'group', 'rules', and 'help' commands #671, #680, #672
• Auto-upgrade embedded commands when running Cog in dev mode #721
• Log warning message when potentially exceeding chat provider's max message size #739

Bug Fixes

• Fixed incorrect YAML prelude in my_bundle.yaml #718 (reported by Tom Bortels)
• Allow administrators to override service and trigger base URLs #694

v0.6.0

Enhancements

• Simplified Command Calling Convention #399, #612, #622, #623, #624, #625
• Implemented Designing For ChatOps guidelines #673, #674, #687

Bug Fixes

• cogctl crashes on mistyped subcommands #685
• Cog can't redirect output to rooms where the invoking user isn't present #676 (reported by Justin Kinney)

v0.5.0

Enhancements

• Memory Service for Commands
• Relay and relay group administrative commands
• ChatOps Design Guide
• Create superuser role during bootstrap
• Added --enable flag to cogctl relays create
• Improved cogctl's option parsing abilities

Bug Fixes

• Clean up cogctl output
• Fixed error when creating relay group with members
• Bootstrap should be idempotent
• Command parser errors on strings containing '.'

v0.4.1

Enhancements

• Enforce enabled/disabled state for Relays

Bug Fixes

• Fix environment generation for non-string command options
• Increase timeout for external HTTP requests to handle slow chat provider API calls

v.0.4.0

Enhancements

• Pipeline Triggers
  • Process external events with command pipelines
  • Flexible output routing
  • Audit log integration
• Brand new Relay written in Go
  • Easier to deploy & configure
  • Replaces previous Relay written in Elixir
• Docker integration
  • Distributed command bundles as Docker images
  • Commands executed inside isolated containers
  • Built-in support for public and private remote registries
• Revised bundle format and deployment process
  • Simplified bundle deployment process -- upload a single file
  • Deploy a bundle to groups of Relays
  • Supported bundle types:
    • Simple
    • Docker
    • Zip file command bundle support EOL'd
  • Simplified bundle config file w/sane defaults
• All new documentation site: http://docs.operable.io
  • GitHub wiki deprecated

Bug Fixes

• Prevent users from creating aliases with fully qualified names
• Slack Real Time Messaging connector crashes on API timeouts
• Ensure pipeline executor permission checks can see all user permissions
• Protect admin group, admin role, and built-in permissions from modification

v0.3.0

Enhancements

• SSL support for Cog <-> Relay communication
• Unix-style command & pipeline aliases
• All new command pipeline execution subsystem
  • Supports nested variable references: $instances[0].tags[1]
  • Improved pipeline execution error messages
  • Removes a number of ugly hacks to handle pipeline execution edge cases
• Simplified installation
  • Removed dirty scheduler and SMP support requirement
  • Spoken command configuration controlled by environment variable
  • HipChat config support added to Docker compose file
• Better error messages
  • Chat adapters aggressively verify their configuration before starting
  • Cog tells unknown users why they are being ignored
• Improved chat command development experience
  • Migrated to YAML for command bundle configuration (inspired by Josh Nichols)
  • Consolidated and simplified command execution model
• JSON path navigation added to filter command
• Experimental IRC adapter (pull requests welcome!)
• Make user first and last name optional when adding new users

Bug Fixes

• Handle Slack-escaped URLs and smart quotes
• Removed old chat adapters from database migrations
• Fixed column ordering bug in table command (reported by James Bowes)
• Route command log output to Relay log file
• Improved handling of unexpected command crashes
• Multiple bugs in mist command bundle (reported by Adam Ochonicki)
• Stopped sending Slack UID to users (reported by Adam Ochonicki)
• Improved output handling of multi commands when called at the end of a pipeline

Documentation

• Documented Cog's permission rule language
• Wiki typo fixes (reported by Jordan Sissel)