@ship-cli/core 0.0.2 → 0.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ship-cli/core",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "type": "module",
   "license": "MIT",
   "description": "Linear + jj workflow CLI for AI agents",

package/src/adapters/driven/linear/IssueRepositoryLive.ts

@@ -453,6 +453,34 @@ const make = Effect.gen(function* () {
       "Removing blocker",
     );
 
+  const addRelated = (
+    taskId: TaskId,
+    relatedTaskId: TaskId,
+  ): Effect.Effect<void, TaskNotFoundError | TaskError | LinearApiError> =>
+    withRetryAndTimeout(
+      Effect.gen(function* () {
+        const client = yield* linearClient.client();
+
+        const result = yield* Effect.tryPromise({
+          try: () =>
+            client.createIssueRelation({
+              issueId: taskId,
+              relatedIssueId: relatedTaskId,
+              type: LinearDocument.IssueRelationType.Related,
+            }),
+          catch: (e) =>
+            new LinearApiError({ message: `Failed to create relation: ${e}`, cause: e }),
+        });
+
+        if (!result.success) {
+          return yield* Effect.fail(
+            new TaskError({ message: "Failed to create related relation" }),
+          );
+        }
+      }),
+      "Adding related",
+    );
+
   const getBranchName = (id: TaskId): Effect.Effect<string, TaskNotFoundError | LinearApiError> =>
     withRetryAndTimeout(
       Effect.gen(function* () {
@@ -492,6 +520,7 @@ const make = Effect.gen(function* () {
     getBlockedTasks,
     addBlocker,
     removeBlocker,
+    addRelated,
     getBranchName,
   };
 });

package/src/adapters/driving/cli/commands/prime.ts

@@ -11,6 +11,39 @@ const formatTaskCompact = (task: Task): string => {
   return `${priority}${task.identifier}: ${task.title} [${task.state.name}]`;
 };
 
+const formatTaskFull = (task: Task): string[] => {
+  const lines: string[] = [];
+  const priority = task.priority === "urgent" ? "!" : task.priority === "high" ? "^" : "";
+
+  lines.push(`### ${priority}${task.identifier}: ${task.title}`);
+  lines.push(`**Status:** ${task.state.name} | **Priority:** ${task.priority}`);
+
+  if (task.labels.length > 0) {
+    lines.push(`**Labels:** ${task.labels.join(", ")}`);
+  }
+
+  if (Option.isSome(task.branchName)) {
+    lines.push(`**Branch:** \`${task.branchName.value}\``);
+  }
+
+  if (task.blockedBy.length > 0) {
+    lines.push(`**Blocked by:** ${task.blockedBy.join(", ")}`);
+  }
+
+  if (task.blocks.length > 0) {
+    lines.push(`**Blocks:** ${task.blocks.join(", ")}`);
+  }
+
+  if (Option.isSome(task.description) && task.description.value.trim()) {
+    lines.push("");
+    lines.push(task.description.value);
+  }
+
+  lines.push(`**URL:** ${task.url}`);
+
+  return lines;
+};
+
 export const primeCommand = Command.make("prime", {}, () =>
   Effect.gen(function* () {
     const config = yield* ConfigRepository;
@@ -45,14 +78,20 @@ export const primeCommand = Command.make("prime", {}, () =>
       lines.push(`Project: ${cfg.linear.projectId.value}`);
     }
 
+    // Show in-progress tasks with FULL details (description, acceptance criteria, etc.)
     if (inProgressTasks.length > 0) {
       lines.push("");
-      lines.push("## In Progress");
+      lines.push("## Current Work (In Progress)");
+      lines.push("");
       for (const task of inProgressTasks) {
-        lines.push(`- ${formatTaskCompact(task)}`);
+        lines.push(...formatTaskFull(task));
+        lines.push("");
+        lines.push("---");
+        lines.push("");
       }
     }
 
+    // Show ready tasks with compact format (just titles)
     if (readyTasks.length > 0) {
       lines.push("");
       lines.push("## Ready to Work");
@@ -64,6 +103,7 @@ export const primeCommand = Command.make("prime", {}, () =>
       }
     }
 
+    // Show blocked tasks with blockers info
     if (blockedTasks.length > 0) {
       lines.push("");
       lines.push("## Blocked");

package/src/adapters/driving/cli/commands/relate.ts

@@ -0,0 +1,56 @@
+import * as Command from "@effect/cli/Command";
+import * as Args from "@effect/cli/Args";
+import * as Options from "@effect/cli/Options";
+import * as Effect from "effect/Effect";
+import * as Console from "effect/Console";
+import { IssueRepository } from "../../../../ports/IssueRepository.js";
+import type { TaskId } from "../../../../domain/Task.js";
+
+const taskAArg = Args.text({ name: "task-a" }).pipe(
+  Args.withDescription("First task identifier (e.g., BRI-123)"),
+);
+
+const taskBArg = Args.text({ name: "task-b" }).pipe(
+  Args.withDescription("Second task identifier (e.g., BRI-456)"),
+);
+
+const jsonOption = Options.boolean("json").pipe(
+  Options.withDescription("Output as JSON"),
+  Options.withDefault(false),
+);
+
+export const relateCommand = Command.make(
+  "relate",
+  { taskA: taskAArg, taskB: taskBArg, json: jsonOption },
+  ({ taskA, taskB, json }) =>
+    Effect.gen(function* () {
+      const issueRepo = yield* IssueRepository;
+
+      // Resolve identifiers to IDs
+      const [resolvedA, resolvedB] = yield* Effect.all([
+        issueRepo
+          .getTaskByIdentifier(taskA)
+          .pipe(Effect.catchTag("TaskNotFoundError", () => issueRepo.getTask(taskA as TaskId))),
+        issueRepo
+          .getTaskByIdentifier(taskB)
+          .pipe(Effect.catchTag("TaskNotFoundError", () => issueRepo.getTask(taskB as TaskId))),
+      ]);
+
+      yield* issueRepo.addRelated(resolvedA.id, resolvedB.id);
+
+      if (json) {
+        yield* Console.log(
+          JSON.stringify({
+            status: "related",
+            taskA: resolvedA.identifier,
+            taskB: resolvedB.identifier,
+          }),
+        );
+      } else {
+        yield* Console.log(`Linked ${resolvedA.identifier} ↔ ${resolvedB.identifier} as related`);
+        yield* Console.log(
+          `\nMentioning ${resolvedA.identifier} in ${resolvedB.identifier}'s description (or vice versa) will now auto-link.`,
+        );
+      }
+    }),
+);

package/src/adapters/driving/cli/commands/update.ts

@@ -0,0 +1,125 @@
+import * as Command from "@effect/cli/Command";
+import * as Args from "@effect/cli/Args";
+import * as Options from "@effect/cli/Options";
+import * as Effect from "effect/Effect";
+import * as Console from "effect/Console";
+import * as Option from "effect/Option";
+import { IssueRepository } from "../../../../ports/IssueRepository.js";
+import {
+  UpdateTaskInput,
+  type TaskId,
+  type Priority,
+  type TaskStatus,
+} from "../../../../domain/Task.js";
+
+const taskIdArg = Args.text({ name: "task-id" }).pipe(
+  Args.withDescription("Task identifier (e.g., ENG-123)"),
+);
+
+const titleOption = Options.text("title").pipe(
+  Options.withAlias("t"),
+  Options.withDescription("New task title"),
+  Options.optional,
+);
+
+const descriptionOption = Options.text("description").pipe(
+  Options.withAlias("d"),
+  Options.withDescription("New task description (use - to read from stdin)"),
+  Options.optional,
+);
+
+const priorityOption = Options.choice("priority", ["urgent", "high", "medium", "low", "none"]).pipe(
+  Options.withAlias("p"),
+  Options.withDescription("New task priority"),
+  Options.optional,
+);
+
+const statusOption = Options.choice("status", [
+  "backlog",
+  "todo",
+  "in_progress",
+  "in_review",
+  "done",
+  "cancelled",
+]).pipe(Options.withAlias("s"), Options.withDescription("New task status"), Options.optional);
+
+const jsonOption = Options.boolean("json").pipe(
+  Options.withDescription("Output as JSON"),
+  Options.withDefault(false),
+);
+
+export const updateCommand = Command.make(
+  "update",
+  {
+    taskId: taskIdArg,
+    title: titleOption,
+    description: descriptionOption,
+    priority: priorityOption,
+    status: statusOption,
+    json: jsonOption,
+  },
+  ({ taskId, title, description, priority, status, json }) =>
+    Effect.gen(function* () {
+      const issueRepo = yield* IssueRepository;
+
+      // Check if any update was provided
+      const hasUpdate =
+        Option.isSome(title) ||
+        Option.isSome(description) ||
+        Option.isSome(priority) ||
+        Option.isSome(status);
+
+      if (!hasUpdate) {
+        yield* Console.error(
+          "No updates provided. Use --title, --description, --priority, or --status.",
+        );
+        return;
+      }
+
+      // Get the task first to resolve identifier to ID
+      const existingTask = yield* issueRepo
+        .getTaskByIdentifier(taskId)
+        .pipe(Effect.catchTag("TaskNotFoundError", () => issueRepo.getTask(taskId as TaskId)));
+
+      // Build update input
+      const input = new UpdateTaskInput({
+        title: Option.isSome(title) ? Option.some(title.value) : Option.none(),
+        description: Option.isSome(description) ? Option.some(description.value) : Option.none(),
+        priority: Option.isSome(priority) ? Option.some(priority.value as Priority) : Option.none(),
+        status: Option.isSome(status) ? Option.some(status.value as TaskStatus) : Option.none(),
+      });
+
+      const task = yield* issueRepo.updateTask(existingTask.id, input);
+
+      if (json) {
+        const output = {
+          status: "updated",
+          task: {
+            id: task.id,
+            identifier: task.identifier,
+            title: task.title,
+            description: Option.getOrNull(task.description),
+            priority: task.priority,
+            state: task.state.name,
+            url: task.url,
+          },
+        };
+        yield* Console.log(JSON.stringify(output, null, 2));
+      } else {
+        yield* Console.log(`Updated: ${task.identifier} - ${task.title}`);
+        if (Option.isSome(title)) {
+          yield* Console.log(`Title: ${task.title}`);
+        }
+        if (Option.isSome(description)) {
+          yield* Console.log(`Description updated`);
+        }
+        if (Option.isSome(priority)) {
+          yield* Console.log(`Priority: ${task.priority}`);
+        }
+        if (Option.isSome(status)) {
+          yield* Console.log(`Status: ${task.state.name}`);
+        }
+        yield* Console.log(`URL: ${task.url}`);
+      }
+    }),
+);

package/src/adapters/driving/cli/main.ts

@@ -14,6 +14,8 @@ import { blockCommand } from "./commands/block.js";
 import { unblockCommand } from "./commands/unblock.js";
 import { blockedCommand } from "./commands/blocked.js";
 import { primeCommand } from "./commands/prime.js";
+import { updateCommand } from "./commands/update.js";
+import { relateCommand } from "./commands/relate.js";
 
 // Root command
 const ship = Command.make("ship", {}, () =>
@@ -35,9 +37,11 @@ Commands:
   
   start <id>        Start working on a task
   done <id>         Mark task as complete
+  update <id>       Update task details
   
   block <a> <b>     Mark task A as blocking task B
   unblock <a> <b>   Remove blocking relationship
+  relate <a> <b>    Link two tasks as related
   
   prime             Output AI-optimized context
 
@@ -56,9 +60,11 @@ export const command = ship.pipe(
     showCommand,
     startCommand,
     doneCommand,
+    updateCommand,
     createCommand,
     blockCommand,
     unblockCommand,
+    relateCommand,
     blockedCommand,
     primeCommand,
   ]),

package/src/ports/IssueRepository.ts

@@ -62,6 +62,12 @@ export interface IssueRepository {
     blockerId: TaskId,
   ) => Effect.Effect<void, TaskNotFoundError | TaskError | LinearApiError>;
 
+  /** Add a "related" relationship between tasks (enables auto-linking in Linear) */
+  readonly addRelated: (
+    taskId: TaskId,
+    relatedTaskId: TaskId,
+  ) => Effect.Effect<void, TaskNotFoundError | TaskError | LinearApiError>;
+
   /** Get the suggested branch name for a task */
   readonly getBranchName: (id: TaskId) => Effect.Effect<string, TaskNotFoundError | LinearApiError>;
 }

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"fileNames":[],"fileInfos":[],"root":[],"options":{"allowJs":false,"checkJs":false,"composite":true,"declaration":true,"declarationMap":true,"downlevelIteration":true,"emitDecoratorMetadata":false,"esModuleInterop":false,"exactOptionalPropertyTypes":true,"experimentalDecorators":true,"module":199,"noEmitOnError":false,"noErrorTruncation":false,"noFallthroughCasesInSwitch":true,"noImplicitAny":true,"noImplicitReturns":false,"noImplicitThis":true,"noUncheckedIndexedAccess":false,"noUnusedLocals":true,"noUnusedParameters":false,"removeComments":false,"skipLibCheck":true,"sourceMap":true,"strict":true,"strictNullChecks":true,"stripInternal":true,"target":9},"version":"5.6.3"}