Skip to content

Add document management and status update commands#2

Merged
skgbafa merged 7 commits into
mainfrom
support-docs
Jan 19, 2026
Merged

Add document management and status update commands#2
skgbafa merged 7 commits into
mainfrom
support-docs

Conversation

@skgbafa

@skgbafa skgbafa commented Jan 19, 2026

Copy link
Copy Markdown
Owner

Summary

  • Add full document management commands (linear document create/list/view/update/delete)
  • Add project status update commands (linear project-update create/list) with alias pu
  • Add initiative status update commands (linear initiative-update create/list) with alias iu

New Commands

Document Management

  • linear document list - List documents (filter by project/issue)
  • linear document view <slug> - View document content
  • linear document create - Create documents (inline, file, stdin, editor)
  • linear document update <slug> - Update documents
  • linear document delete <slug> - Delete documents (soft/permanent, bulk)

Project Status Updates

  • linear project-update create <projectId> - Post timeline updates to projects
  • linear project-update list <projectId> - List project status updates
  • Supports --health flag (onTrack/atRisk/offTrack)
  • Alias: pu

Initiative Status Updates

  • linear initiative-update create <initiativeId> - Post timeline updates to initiatives
  • linear initiative-update list <initiativeId> - List initiative status updates
  • Supports --health flag (onTrack/atRisk/offTrack)
  • Alias: iu

Test plan

  • Document commands tested with comprehensive test suite
  • Project-update and initiative-update commands verified manually
  • All commands accessible via linear --help

- Create test files for all 5 document subcommands:
  - document-list.test.ts: tests for listing documents with filters
  - document-view.test.ts: tests for viewing document content
  - document-create.test.ts: tests for creating documents
  - document-update.test.ts: tests for updating documents
  - document-delete.test.ts: tests for soft/permanent deletion
- Update README.md with document command usage examples
- Tests follow existing patterns using MockLinearServer and snapshot testing
- Tests will compile once command implementations are completed
- Create document-delete.ts with soft delete support
- Linear API only supports soft delete (moves to trash), no permanent deletion
- Implemented single delete with confirmation prompt and -y flag to skip
- Implemented bulk delete with --bulk, --bulk-file, and --bulk-stdin support
- Updated document-delete.test.ts to match implementation
Add document-update.ts with partial update support:
- --title: Update document title
- --content: Inline content update
- --content-file: Read content from file
- --icon: Update document icon
- --edit: Open current content in $EDITOR for editing

Includes openEditorWithContent helper for --edit mode that fetches
current document content, opens editor, and submits changes.
Add document-create.ts with full support for creating Linear documents:
- Support for --title, --content, --content-file, --project, --issue, --icon flags
- Content resolution from inline, file, stdin, and $EDITOR
- Interactive mode (-i) with prompts for all fields
- Project and issue attachment support

Also creates document.ts parent command and registers it in main.ts.
@skgbafa skgbafa merged commit 9bc23c3 into main Jan 19, 2026
@skgbafa skgbafa deleted the support-docs branch January 19, 2026 02:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant