feat: Rename spine to timeline, add virtual command visualization for Docker #71

konard · 2026-01-08T14:56:05Z

Summary

This PR implements the requirements from issue #70:

Renamed "spine" to "timeline": The internal terminology for the │ prefixed output format has been renamed from "status spine" to "timeline" format throughout the codebase. Old names are deprecated but still available for backwards compatibility.
Virtual command visualization for Docker: When running commands in Docker isolation that require pulling an image, the pull step is now shown as a separate virtual command in the timeline output:
- $ docker pull <image> appears before the user command
- The pull output is streamed in real-time
- Result markers (✓/✗) indicate success/failure
- Only displayed when the image actually needs to be pulled (conditional display)
New API additions:
- TIMELINE_MARKER constant (replaces deprecated SPINE)
- create_timeline_line() (replaces deprecated create_spine_line())
- create_empty_timeline_line() (replaces deprecated create_empty_spine_line())
- create_virtual_command_block() - for formatting virtual commands
- create_virtual_command_result() - for result markers
- docker_image_exists() - check if image is available locally
- docker_pull_image() - pull with streaming output
- StartBlockOptions.defer_command - defer command display for multi-step execution
CI/CD version protection: Added checks to prevent manual version changes in PRs:
- JavaScript CI (js.yml): Fails if package.json version is modified
- Rust CI (rust.yml): Fails if Cargo.toml version is modified
- Skips automated release PRs (changeset-release/, changeset-js-)
- This ensures versions are only changed by the CI/CD pipeline, preventing merge conflicts

Example Output

When the Docker image needs to be pulled:

│ session   abc-123-def-456
│ start     2025-01-08 10:30:00
│
│ isolation docker
│ mode      attached
│ image     alpine:latest
│ container docker-container-789
│
$ docker pull alpine:latest

Using default tag: latest
latest: Pulling from library/alpine
...

✓
│
$ echo hi

hi

✓
│ finish    2025-01-08 10:30:05
│ duration  5.123s
│ exit      0
│
│ log       /tmp/start-command-xyz.log
│ session   abc-123-def-456

When the image is already available locally, the docker pull virtual command is skipped.

Test plan

All existing tests pass (147 tests)
New test for defer_command option added
Test constants updated to use TIMELINE_MARKER
Manual testing with Docker isolation
CI version checks added and verified working
Version changes reverted to original values

Breaking changes

None - all renamed items have deprecated aliases that still work.

Fixes #70

🤖 Generated with Claude Code

Adding CLAUDE.md with task information for AI processing. This file will be removed when the task is complete. Issue: #70

…on for Docker This commit implements issue #70 with the following changes: 1. Renamed "spine" concept to "timeline" throughout the codebase: - SPINE constant renamed to TIMELINE_MARKER (with deprecated alias) - create_spine_line renamed to create_timeline_line (with deprecated alias) - create_empty_spine_line renamed to create_empty_timeline_line (with deprecated alias) - Updated documentation in output_blocks.rs, REQUIREMENTS.md, ARCHITECTURE.md 2. Added virtual command visualization for Docker isolation: - When Docker needs to pull an image, it's shown as a separate virtual command - `$ docker pull <image>` is displayed before the actual user command - Pull output is streamed with result marker (✓ or ✗) - Virtual commands only appear when the image needs to be pulled 3. New functions for virtual command support: - docker_image_exists() - Check if a Docker image exists locally - docker_pull_image() - Pull image with streaming output - create_virtual_command_block() - Format virtual command line - create_virtual_command_result() - Format result marker for virtual commands - create_timeline_separator() - Separator between virtual and user commands 4. StartBlockOptions now has defer_command field: - When true, command line is omitted from start block - Used for Docker isolation to show virtual commands first 5. Version bumped to 0.20.0 Example output when pulling an image: ``` │ session ... │ start ... │ │ isolation docker │ $ docker pull alpine:latest ... pull output ... ✓ │ $ echo hi hi ✓ ``` 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>

This reverts commit 63467fb.

konard · 2026-01-08T15:07:34Z

🤖 Solution Draft Log

This log file contains the complete execution trace of the AI solution draft process.

💰 Cost estimation:

Public pricing estimate: $7.959036 USD
Calculated by Anthropic: $5.621979 USD
Difference: $-2.337057 (-29.36%)
📎 Log file uploaded as GitHub Gist (1525KB)
🔗 View complete solution draft log

Now working session is ended, feel free to review and add any feedback on the solution draft.

konard · 2026-01-08T15:11:16Z

🤖 AI Work Session Started

Starting automated work session at 2026-01-08T15:11:14.220Z

The PR has been converted to draft mode while work is in progress.

This comment marks the beginning of an AI work session. Please wait working session to finish, and provide your feedback.

- Added Rust changelog fragment (rust/changelog.d/70.md) documenting the spine → timeline rename and virtual command features - Added JavaScript changeset (js/.changeset/issue-70-timeline-virtual-commands.md) for version management - Fixed Clippy deprecation warnings by adding #[allow(deprecated)] to re-exports of deprecated items - Renamed test function test_create_spine_line → test_create_timeline_line to use new API All changes ensure CI checks pass while maintaining backward compatibility with deprecated API names. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

Removed bold markdown syntax and adjusted formatting to comply with Prettier's style requirements. This should resolve the JavaScript CI/CD formatting check failure. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

konard · 2026-01-08T15:27:02Z

🤖 Solution Draft Log

This log file contains the complete execution trace of the AI solution draft process.

💰 Cost estimation:

Public pricing estimate: $2.723545 USD
Calculated by Anthropic: $1.897841 USD
Difference: $-0.825704 (-30.32%)
📎 Log file uploaded as GitHub Gist (481KB)
🔗 View complete solution draft log

Now working session is ended, feel free to review and add any feedback on the solution draft.

konard · 2026-01-08T15:31:13Z

Or changeset CI/CD checks in both languages should prohibit changes in package.json version or cargo.toml version, to make sure we reduce conflicts posibility, and explicitly demand no manual changes to package/crate versions in both js.yml and rust.yml

So with current changes CI/CD must fail, not pass in Pull Requests. So we will never repeat the same problem again in the future.

konard · 2026-01-08T15:32:28Z

🤖 AI Work Session Started

Starting automated work session at 2026-01-08T15:32:26.072Z

The PR has been converted to draft mode while work is in progress.

This comment marks the beginning of an AI work session. Please wait working session to finish, and provide your feedback.

- Add "Check for Manual Version Changes" job to js.yml that fails if package.json version is modified (skips automated release PRs) - Add "Check for Manual Version Changes" job to rust.yml that fails if Cargo.toml version is modified - Revert manual version changes that were introduced in previous commits - js/package.json: 0.20.0 → 0.19.1 - rust/Cargo.toml: 0.20.0 → 0.14.0 This ensures versions are only changed by the CI/CD pipeline through changesets (JS) or changelog fragments (Rust), preventing merge conflicts and maintaining consistent release workflows. Addresses feedback from PR #71 comments. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>

konard · 2026-01-08T15:40:25Z

Changes Implemented

Based on the feedback to add CI checks that prohibit manual version changes:

CI/CD Protection Added

JavaScript CI (js.yml):

Added new job "Check for Manual Version Changes"
Fails if package.json version is modified in a PR
Skips check for automated release PRs (changeset-release/*, changeset-js-*)

Rust CI (rust.yml):

Added new job "Check for Manual Version Changes"
Fails if Cargo.toml version is modified in a PR

Version Reverts

Reverted the manual version changes that were previously committed:

js/package.json: 0.20.0 → 0.19.1 (back to original)
rust/Cargo.toml: 0.20.0 → 0.14.0 (back to original)

Verification

✅ Both CI runs passed with the new version checks
✅ Version checks successfully detected no manual changes after revert

This ensures that versions are only changed through the automated CI/CD pipeline (changesets for JS, changelog fragments for Rust), preventing merge conflicts from conflicting version bumps in PRs.

konard · 2026-01-08T15:40:42Z

🤖 Solution Draft Log

This log file contains the complete execution trace of the AI solution draft process.

💰 Cost estimation:

Public pricing estimate: $2.601122 USD
Calculated by Anthropic: $1.662803 USD
Difference: $-0.938319 (-36.07%)
📎 Log file uploaded as GitHub Gist (401KB)
🔗 View complete solution draft log

Now working session is ended, feel free to review and add any feedback on the solution draft.

Initial commit with task details

63467fb

Adding CLAUDE.md with task information for AI processing. This file will be removed when the task is complete. Issue: #70

konard self-assigned this Jan 8, 2026

konard changed the title ~~[WIP] Rename spine to timeline, support virtual commands visualization for multistep execution, and isolation backend to isolation environment~~ feat: Rename spine to timeline, add virtual command visualization for Docker Jan 8, 2026

konard marked this pull request as ready for review January 8, 2026 15:07

Revert "Initial commit with task details"

9ec7aa7

This reverts commit 63467fb.

konard marked this pull request as draft January 8, 2026 15:11

konard and others added 2 commits January 8, 2026 16:18

konard marked this pull request as ready for review January 8, 2026 15:26

konard marked this pull request as draft January 8, 2026 15:32

konard marked this pull request as ready for review January 8, 2026 15:40

konard merged commit d166655 into main Jan 8, 2026
20 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: Rename spine to timeline, add virtual command visualization for Docker #71

feat: Rename spine to timeline, add virtual command visualization for Docker #71

Uh oh!

konard commented Jan 8, 2026 •

edited

Loading

Uh oh!

konard commented Jan 8, 2026

Uh oh!

konard commented Jan 8, 2026

Uh oh!

konard commented Jan 8, 2026

Uh oh!

konard commented Jan 8, 2026 •

edited

Loading

Uh oh!

konard commented Jan 8, 2026

Uh oh!

konard commented Jan 8, 2026

Uh oh!

konard commented Jan 8, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

feat: Rename spine to timeline, add virtual command visualization for Docker #71

feat: Rename spine to timeline, add virtual command visualization for Docker #71

Uh oh!

Conversation

konard commented Jan 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Example Output

Test plan

Breaking changes

Uh oh!

konard commented Jan 8, 2026

🤖 Solution Draft Log

Uh oh!

konard commented Jan 8, 2026

Uh oh!

konard commented Jan 8, 2026

🤖 Solution Draft Log

Uh oh!

konard commented Jan 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

konard commented Jan 8, 2026

Uh oh!

konard commented Jan 8, 2026

Changes Implemented

CI/CD Protection Added

Version Reverts

Verification

Uh oh!

konard commented Jan 8, 2026

🤖 Solution Draft Log

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

konard commented Jan 8, 2026 •

edited

Loading

konard commented Jan 8, 2026 •

edited

Loading