@elnora-ai/linear 1.0.0

package/schemas/repos.json

@@ -0,0 +1,41 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://github.com/Elnora-AI/elnora-linear/blob/main/schemas/repos.json",
+	"title": "Repos",
+	"description": "GitHub repositories the curator scans for signals (commits, PRs). Populated by `linear-sync repos`.",
+	"type": "object",
+	"additionalProperties": false,
+	"properties": {
+		"$schema": { "type": "string" },
+		"_placeholder": { "type": "boolean", "const": true },
+		"_example": { "type": "boolean", "const": true },
+		"_populated_by": { "type": "string" },
+		"repos": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"additionalProperties": false,
+				"properties": {
+					"name": {
+						"type": "string",
+						"description": "Repository name (without org)"
+					},
+					"org": {
+						"type": "string",
+						"description": "GitHub org or user that owns the repo"
+					},
+					"local_path": {
+						"type": "string",
+						"description": "Optional local clone path for git-log scans; supports leading ~"
+					},
+					"default_branch": {
+						"type": "string",
+						"default": "main"
+					}
+				},
+				"required": ["name"]
+			}
+		}
+	},
+	"required": ["repos"]
+}

package/schemas/signal-sources.json

@@ -0,0 +1,90 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://github.com/Elnora-AI/elnora-linear/blob/main/schemas/signal-sources.json",
+	"title": "Signal Sources",
+	"description": "Pluggable signal sources the curator consults when validating Linear issue state. Each source has a `type` that dispatches to a built-in collector (github_commits, github_pr, slack_messages, linear_issues) or generic extension point (external_command, mcp_tool).",
+	"type": "object",
+	"additionalProperties": false,
+	"properties": {
+		"$schema": { "type": "string" },
+		"_placeholder": { "type": "boolean", "const": true },
+		"_example": { "type": "boolean", "const": true },
+		"_populated_by": { "type": "string" },
+		"sources": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["type", "name"],
+				"properties": {
+					"type": {
+						"type": "string",
+						"enum": [
+							"github_commits",
+							"github_pr",
+							"slack_messages",
+							"linear_issues",
+							"external_command",
+							"mcp_tool"
+						]
+					},
+					"name": {
+						"type": "string",
+						"description": "Human-readable identifier for this source in curator reports"
+					},
+					"enabled": { "type": "boolean", "default": true }
+				},
+				"allOf": [
+					{
+						"if": { "properties": { "type": { "const": "github_commits" } }, "required": ["type"] },
+						"then": {
+							"properties": {
+								"repos": { "type": "array", "items": { "type": "string" } },
+								"lookback_days": { "type": "integer", "minimum": 1, "maximum": 365 }
+							}
+						}
+					},
+					{
+						"if": { "properties": { "type": { "const": "github_pr" } }, "required": ["type"] },
+						"then": {
+							"properties": {
+								"repos": { "type": "array", "items": { "type": "string" } }
+							}
+						}
+					},
+					{
+						"if": { "properties": { "type": { "const": "slack_messages" } }, "required": ["type"] },
+						"then": {
+							"properties": {
+								"channels": { "type": "array", "items": { "type": "string" } },
+								"match_patterns": { "type": "array", "items": { "type": "string" } }
+							}
+						}
+					},
+					{
+						"if": { "properties": { "type": { "const": "external_command" } }, "required": ["type"] },
+						"then": {
+							"required": ["command"],
+							"properties": {
+								"command": { "type": "string", "minLength": 1 },
+								"parse_as": { "type": "string", "enum": ["json", "lines", "regex"] },
+								"issue_match_field": { "type": "string" }
+							}
+						}
+					},
+					{
+						"if": { "properties": { "type": { "const": "mcp_tool" } }, "required": ["type"] },
+						"then": {
+							"required": ["server", "tool"],
+							"properties": {
+								"server": { "type": "string" },
+								"tool": { "type": "string" },
+								"args": { "type": "object" }
+							}
+						}
+					}
+				]
+			}
+		}
+	},
+	"required": ["sources"]
+}

package/schemas/slack.json

@@ -0,0 +1,45 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://github.com/Elnora-AI/elnora-linear/blob/main/schemas/slack.json",
+	"title": "Slack",
+	"description": "Slack channels + outbound-routing allowlists used by the curator. Allowlists are an intentional security model: the curator never posts to channels or DMs not explicitly listed here.",
+	"type": "object",
+	"additionalProperties": false,
+	"properties": {
+		"$schema": { "type": "string" },
+		"_placeholder": { "type": "boolean", "const": true },
+		"_example": { "type": "boolean", "const": true },
+		"_populated_by": { "type": "string" },
+		"channels": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"additionalProperties": false,
+				"properties": {
+					"id": {
+						"type": "string",
+						"pattern": "^C[A-Z0-9]+$",
+						"description": "Slack channel ID"
+					},
+					"name": {
+						"type": "string",
+						"description": "Channel name without the leading #"
+					},
+					"purpose": { "type": "string" }
+				},
+				"required": ["id", "name"]
+			}
+		},
+		"allowed_channels": {
+			"type": "array",
+			"items": { "type": "string", "pattern": "^C[A-Z0-9]+$" },
+			"description": "Channel IDs the curator is permitted to post in. Posts to unlisted channels are silently dropped."
+		},
+		"allowed_dm_users": {
+			"type": "array",
+			"items": { "type": "string" },
+			"description": "User keys (resolving via users.json to slack_user_id) the curator is permitted to DM."
+		}
+	},
+	"required": ["channels", "allowed_channels", "allowed_dm_users"]
+}

package/schemas/teams.json

@@ -0,0 +1,43 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://github.com/Elnora-AI/elnora-linear/blob/main/schemas/teams.json",
+	"title": "Teams",
+	"description": "Linear teams the plugin operates on. Populated by `linear-sync teams` from the Linear API.",
+	"type": "object",
+	"additionalProperties": false,
+	"properties": {
+		"$schema": { "type": "string" },
+		"_placeholder": { "type": "boolean", "const": true },
+		"_example": { "type": "boolean", "const": true },
+		"_populated_by": { "type": "string" },
+		"teams": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"additionalProperties": false,
+				"properties": {
+					"key": {
+						"type": "string",
+						"pattern": "^[A-Z]{2,8}$",
+						"description": "Linear team key / issue prefix, e.g. ENG"
+					},
+					"name": {
+						"type": "string",
+						"minLength": 1,
+						"description": "Human-readable team name from Linear"
+					},
+					"description": {
+						"type": "string",
+						"description": "Optional one-line description"
+					},
+					"default_project": {
+						"type": "string",
+						"description": "Optional default project name for new issues on this team"
+					}
+				},
+				"required": ["key", "name"]
+			}
+		}
+	},
+	"required": ["teams"]
+}

package/schemas/users.json

@@ -0,0 +1,41 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://github.com/Elnora-AI/elnora-linear/blob/main/schemas/users.json",
+	"title": "Users",
+	"description": "Users referenced by name across the workspace. Populated by `linear-sync users` from the Linear API; optional Slack user IDs added via `linear-sync slack`.",
+	"type": "object",
+	"additionalProperties": false,
+	"properties": {
+		"$schema": { "type": "string" },
+		"_placeholder": { "type": "boolean", "const": true },
+		"_example": { "type": "boolean", "const": true },
+		"_populated_by": { "type": "string" },
+		"users": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"additionalProperties": false,
+				"properties": {
+					"key": {
+						"type": "string",
+						"pattern": "^[a-z][a-z0-9_-]*$",
+						"description": "Short handle used across other reference files (e.g. project lead, signal recipient)"
+					},
+					"name": { "type": "string", "minLength": 1 },
+					"email": { "type": "string", "format": "email" },
+					"linear_user_id": {
+						"type": "string",
+						"description": "Linear UUID, resolved via API"
+					},
+					"slack_user_id": {
+						"type": "string",
+						"pattern": "^U[A-Z0-9]+$",
+						"description": "Slack user ID for direct messages (optional; only set if curator messaging is enabled)"
+					}
+				},
+				"required": ["key", "name"]
+			}
+		}
+	},
+	"required": ["users"]
+}

package/schemas/workflows.json

@@ -0,0 +1,61 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://github.com/Elnora-AI/elnora-linear/blob/main/schemas/workflows.json",
+	"title": "Workflows",
+	"description": "Linear workflow states (fetched from the API) plus user-defined curator rules. Rules are tiered: high = auto-apply, medium = ask the assignee, low = surface in summary report only.",
+	"type": "object",
+	"additionalProperties": false,
+	"properties": {
+		"$schema": { "type": "string" },
+		"_placeholder": { "type": "boolean", "const": true },
+		"_example": { "type": "boolean", "const": true },
+		"_populated_by": { "type": "string" },
+		"states": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"additionalProperties": false,
+				"properties": {
+					"name": { "type": "string", "minLength": 1 },
+					"type": {
+						"type": "string",
+						"enum": ["backlog", "unstarted", "started", "completed", "canceled", "triage"]
+					}
+				},
+				"required": ["name", "type"]
+			}
+		},
+		"rules": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"additionalProperties": false,
+				"required": ["id", "tier", "description", "when", "action"],
+				"properties": {
+					"id": {
+						"type": "string",
+						"pattern": "^[a-z][a-z0-9-]*$",
+						"description": "Stable rule identifier surfaced in audit logs"
+					},
+					"tier": {
+						"type": "string",
+						"enum": ["high", "medium", "low"],
+						"description": "high = auto-apply; medium = ask assignee; low = report only"
+					},
+					"description": { "type": "string", "minLength": 1 },
+					"when": {
+						"type": "object",
+						"description": "Match conditions; the curator evaluates these against signals and issue state",
+						"additionalProperties": true
+					},
+					"action": {
+						"type": "object",
+						"description": "What to do when the rule matches",
+						"additionalProperties": true
+					}
+				}
+			}
+		}
+	},
+	"required": ["states", "rules"]
+}

package/skills/linear-workspace/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: linear-workspace
+description: >
+  Linear issue management — routes work to specialized agents and slash commands.
+  Use when: creating, updating, searching, bulk-editing, cleaning up, syncing Linear.
+  TRIGGERS: "linear", "ticket", "issue", "create issue", "update issue", "search issues",
+  "my issues", "bulk", "cleanup", "sync", "log bug", "file issue", "report bug",
+  "new ticket", "add task", "open ticket", "open issue", "throw this in linear",
+  "track this in linear", "capture as issue", "put on the backlog".
+---
+
+# Linear Workspace
+
+Router for Linear work. Dispatches to specialized agents or slash commands rather than running things inline.
+
+## Dispatch table
+
+| Intent | Action |
+|---|---|
+| Create one issue from a description | Agent: `linear-issue-creator` |
+| Create issues from a URL / article / design | Agent: `linear-url-to-issues` |
+| Review one existing issue (clarity, completeness) | Agent: `linear-issue-reviewer` |
+| Edit one existing issue (state, assignee, comment, close, …) | Agent: `linear-issue-updater` |
+| Search / list issues | Slash command: `/linear-search` |
+| List your own issues | Slash command: `/linear-my-issues` |
+| Apply the same change to many issues | Slash command: `/linear-bulk` |
+| Find + handle stale issues | Slash command: `/linear-cleanup` |
+| Refresh reference data from Linear | Slash command: `/linear-sync` |
+| Run the curator (collect signals from external sources) | Slash command: `/linear-curator-run` |
+
+## First-run install
+
+1. Install the plugin: `/plugin marketplace add Elnora-AI/elnora-linear` then `/plugin install linear-workspace@elnora-linear`
+2. Make sure the `elnora-linear` CLI is on your PATH: `npm install -g @elnora-ai/linear`
+3. On your first Linear command, you'll be prompted for your Linear API key (get one at https://linear.app/settings/api). It's saved to `~/.config/elnora-linear/.env` (mode 0600).
+4. Populate the reference files: `/linear-sync` (runs `elnora-linear sync all` — fetches teams, projects, users, workflows in one batch).
+
+## Reference files
+
+The plugin reads user-specific config from `~/.config/elnora-linear/` by default (override via `LINEAR_REFERENCES_DIR`):
+
+- `teams.json`, `projects.json`, `users.json`, `workflows.json` — populated by `/linear-sync`
+- `slack.json`, `repos.json`, `signal-sources.json` — populated manually in v0; interactive prompts coming in a future release
+
+Run `elnora-linear sync verify` to see which are populated vs placeholder.
+
+## Safety guardrails
+
+- `bulk` and `cleanup` default to **dry-run**; they print what would change and require explicit `--yes` to commit
+- `bulk` requires at least one of `--set-state` or `--add-comment` — refuses no-op invocations
+- `cleanup` defaults to `comment` action (least destructive); `close` / `cancel` are explicit opt-ins
+- `external_command` signal sources run user-configured commands with the user's privileges — only configure commands from sources the user trusts