@ship-cli/core 0.0.1 → 0.0.3

package/dist/bin.js

@@ -33924,7 +33924,9 @@ var startCommand = make58(
       if (json2) {
         yield* log3(JSON.stringify({ status: "already_in_progress", task: taskId }));
       } else {
-        yield* log3(`Task ${task.identifier} is already in progress (${task.state.name}).`);
+        yield* log3(
+          `Task ${task.identifier} is already in progress (${task.state.name}).`
+        );
       }
       return;
     }
@@ -34239,28 +34241,6 @@ var blockedCommand = make58(
 );
 
 // src/adapters/driving/cli/commands/prime.ts
-var AGENT_GUIDANCE = `## Agent Restrictions
-
-1. **Never create issues without user confirmation**
-2. **Check blockers before starting work** - blocked tasks should be surfaced
-3. **Small, focused tasks only** - if a task seems too large, suggest splitting
-4. **Always update status** - in_progress when starting, done when complete
-5. **Stack blocking tasks** - work on blockers first, stack changes appropriately
-6. **Use conventional commits** - format: type(TASK-ID): description
-
-## CLI Commands
-
-- \`ship ready --json\` - List tasks with no blockers
-- \`ship show <id> --json\` - Show task details
-- \`ship start <id>\` - Begin work (sets status to in_progress)
-- \`ship done <id> --reason "msg"\` - Complete task
-- \`ship blocked --json\` - Show blocked tasks
-- \`ship block <blocker> <blocked>\` - Create blocking relationship
-- \`ship unblock <blocker> <blocked>\` - Remove blocking relationship
-- \`ship list --json\` - List all tasks
-- \`ship create "title" -p priority -t type\` - Create new task
-
-Always use \`--json\` flag for programmatic output.`;
 var formatTaskCompact = (task) => {
   const priority = task.priority === "urgent" ? "!" : task.priority === "high" ? "^" : "";
   return `${priority}${task.identifier}: ${task.title} [${task.state.name}]`;
@@ -34286,20 +34266,19 @@ var primeCommand = make58(
     const allTasks = yield* issueRepo.listTasks(cfg.linear.teamId, filter11);
     const inProgressTasks = allTasks.filter((t2) => t2.state.type === "started");
     const lines3 = [];
-    lines3.push("<ship-context>");
     lines3.push(`Team: ${cfg.linear.teamKey}`);
     if (isSome2(cfg.linear.projectId)) {
       lines3.push(`Project: ${cfg.linear.projectId.value}`);
     }
-    lines3.push("");
     if (inProgressTasks.length > 0) {
+      lines3.push("");
       lines3.push("## In Progress");
       for (const task of inProgressTasks) {
         lines3.push(`- ${formatTaskCompact(task)}`);
       }
-      lines3.push("");
     }
     if (readyTasks.length > 0) {
+      lines3.push("");
       lines3.push("## Ready to Work");
       for (const task of readyTasks.slice(0, 10)) {
         lines3.push(`- ${formatTaskCompact(task)}`);
@@ -34307,9 +34286,9 @@ var primeCommand = make58(
       if (readyTasks.length > 10) {
         lines3.push(`  ... and ${readyTasks.length - 10} more`);
       }
-      lines3.push("");
     }
     if (blockedTasks.length > 0) {
+      lines3.push("");
       lines3.push("## Blocked");
       for (const task of blockedTasks.slice(0, 5)) {
         lines3.push(`- ${formatTaskCompact(task)}`);
@@ -34320,13 +34299,7 @@ var primeCommand = make58(
       if (blockedTasks.length > 5) {
         lines3.push(`  ... and ${blockedTasks.length - 5} more`);
       }
-      lines3.push("");
     }
-    lines3.push("</ship-context>");
-    lines3.push("");
-    lines3.push("<ship-guidance>");
-    lines3.push(AGENT_GUIDANCE);
-    lines3.push("</ship-guidance>");
     yield* log3(lines3.join("\n"));
   })
 );
@@ -49133,7 +49106,9 @@ var make72 = gen2(function* () {
         catch: (e3) => new LinearApiError({ message: `Failed to create relation: ${e3}`, cause: e3 })
       });
       if (!result.success) {
-        return yield* fail7(new TaskError({ message: "Failed to create blocking relation" }));
+        return yield* fail7(
+          new TaskError({ message: "Failed to create blocking relation" })
+        );
       }
     }),
     "Adding blocker"

package/package.json

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

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

@@ -388,11 +388,14 @@ const make = Effect.gen(function* () {
               relatedIssueId: blockerId,
               type: LinearDocument.IssueRelationType.Blocks,
             }),
-          catch: (e) => new LinearApiError({ message: `Failed to create relation: ${e}`, cause: e }),
+          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 blocking relation" }));
+          return yield* Effect.fail(
+            new TaskError({ message: "Failed to create blocking relation" }),
+          );
         }
       }),
       "Adding blocker",
@@ -417,7 +420,8 @@ const make = Effect.gen(function* () {
 
         const relations = yield* Effect.tryPromise({
           try: () => blocked.relations(),
-          catch: (e) => new LinearApiError({ message: `Failed to fetch relations: ${e}`, cause: e }),
+          catch: (e) =>
+            new LinearApiError({ message: `Failed to fetch relations: ${e}`, cause: e }),
         });
 
         const relationToDelete = yield* Effect.tryPromise({
@@ -442,12 +446,41 @@ const make = Effect.gen(function* () {
 
         yield* Effect.tryPromise({
           try: () => client.deleteIssueRelation(relationToDelete.id),
-          catch: (e) => new LinearApiError({ message: `Failed to delete relation: ${e}`, cause: e }),
+          catch: (e) =>
+            new LinearApiError({ message: `Failed to delete relation: ${e}`, cause: e }),
         });
       }),
       "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* () {
@@ -487,6 +520,7 @@ const make = Effect.gen(function* () {
     getBlockedTasks,
     addBlocker,
     removeBlocker,
+    addRelated,
     getBranchName,
   };
 });

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

@@ -82,7 +82,8 @@ const make = Effect.gen(function* () {
             if (!t) throw new Error("Team not returned");
             return t;
           },
-          catch: (e) => new LinearApiError({ message: `Failed to get created team: ${e}`, cause: e }),
+          catch: (e) =>
+            new LinearApiError({ message: `Failed to get created team: ${e}`, cause: e }),
         });
 
         return mapTeam(team);

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

@@ -6,32 +6,42 @@ import { ConfigRepository } from "../../../../ports/ConfigRepository.js";
 import { IssueRepository } from "../../../../ports/IssueRepository.js";
 import { TaskFilter, type Task } from "../../../../domain/Task.js";
 
-const AGENT_GUIDANCE = `## Agent Restrictions
+const formatTaskCompact = (task: Task): string => {
+  const priority = task.priority === "urgent" ? "!" : task.priority === "high" ? "^" : "";
+  return `${priority}${task.identifier}: ${task.title} [${task.state.name}]`;
+};
 
-1. **Never create issues without user confirmation**
-2. **Check blockers before starting work** - blocked tasks should be surfaced
-3. **Small, focused tasks only** - if a task seems too large, suggest splitting
-4. **Always update status** - in_progress when starting, done when complete
-5. **Stack blocking tasks** - work on blockers first, stack changes appropriately
-6. **Use conventional commits** - format: type(TASK-ID): description
+const formatTaskFull = (task: Task): string[] => {
+  const lines: string[] = [];
+  const priority = task.priority === "urgent" ? "!" : task.priority === "high" ? "^" : "";
 
-## CLI Commands
+  lines.push(`### ${priority}${task.identifier}: ${task.title}`);
+  lines.push(`**Status:** ${task.state.name} | **Priority:** ${task.priority}`);
 
-- \`ship ready --json\` - List tasks with no blockers
-- \`ship show <id> --json\` - Show task details
-- \`ship start <id>\` - Begin work (sets status to in_progress)
-- \`ship done <id> --reason "msg"\` - Complete task
-- \`ship blocked --json\` - Show blocked tasks
-- \`ship block <blocker> <blocked>\` - Create blocking relationship
-- \`ship unblock <blocker> <blocked>\` - Remove blocking relationship
-- \`ship list --json\` - List all tasks
-- \`ship create "title" -p priority -t type\` - Create new task
+  if (task.labels.length > 0) {
+    lines.push(`**Labels:** ${task.labels.join(", ")}`);
+  }
 
-Always use \`--json\` flag for programmatic output.`;
+  if (Option.isSome(task.branchName)) {
+    lines.push(`**Branch:** \`${task.branchName.value}\``);
+  }
 
-const formatTaskCompact = (task: Task): string => {
-  const priority = task.priority === "urgent" ? "!" : task.priority === "high" ? "^" : "";
-  return `${priority}${task.identifier}: ${task.title} [${task.state.name}]`;
+  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", {}, () =>
@@ -60,25 +70,30 @@ export const primeCommand = Command.make("prime", {}, () =>
     // Filter to only "started" state type tasks
     const inProgressTasks = allTasks.filter((t: Task) => t.state.type === "started");
 
-    // Build context output
+    // Build context output (plain markdown, no XML tags - plugin wraps it)
     const lines: string[] = [];
 
-    lines.push("<ship-context>");
     lines.push(`Team: ${cfg.linear.teamKey}`);
     if (Option.isSome(cfg.linear.projectId)) {
       lines.push(`Project: ${cfg.linear.projectId.value}`);
     }
-    lines.push("");
 
+    // Show in-progress tasks with FULL details (description, acceptance criteria, etc.)
     if (inProgressTasks.length > 0) {
-      lines.push("## In Progress");
+      lines.push("");
+      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("");
       }
-      lines.push("");
     }
 
+    // Show ready tasks with compact format (just titles)
     if (readyTasks.length > 0) {
+      lines.push("");
       lines.push("## Ready to Work");
       for (const task of readyTasks.slice(0, 10)) {
         lines.push(`- ${formatTaskCompact(task)}`);
@@ -86,10 +101,11 @@ export const primeCommand = Command.make("prime", {}, () =>
       if (readyTasks.length > 10) {
         lines.push(`  ... and ${readyTasks.length - 10} more`);
       }
-      lines.push("");
     }
 
+    // Show blocked tasks with blockers info
     if (blockedTasks.length > 0) {
+      lines.push("");
       lines.push("## Blocked");
       for (const task of blockedTasks.slice(0, 5)) {
         lines.push(`- ${formatTaskCompact(task)}`);
@@ -100,15 +116,8 @@ export const primeCommand = Command.make("prime", {}, () =>
       if (blockedTasks.length > 5) {
         lines.push(`  ... and ${blockedTasks.length - 5} more`);
       }
-      lines.push("");
     }
 
-    lines.push("</ship-context>");
-    lines.push("");
-    lines.push("<ship-guidance>");
-    lines.push(AGENT_GUIDANCE);
-    lines.push("</ship-guidance>");
-
     yield* Console.log(lines.join("\n"));
   }),
 );

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/start.ts

@@ -37,7 +37,9 @@ export const startCommand = Command.make(
         if (json) {
           yield* Console.log(JSON.stringify({ status: "already_in_progress", task: taskId }));
         } else {
-          yield* Console.log(`Task ${task.identifier} is already in progress (${task.state.name}).`);
+          yield* Console.log(
+            `Task ${task.identifier} is already in progress (${task.state.name}).`,
+          );
         }
         return;
       }

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

@@ -40,14 +40,15 @@ export const teamCommand = Command.make("team", {}, () =>
 
     // Select team or create new
     const currentTeamId = Option.isSome(partial.linear) ? partial.linear.value.teamId : null;
-    const teamOptions: Array<{ value: TeamId | typeof CREATE_NEW; label: string; hint?: string }> = [
-      ...teams.map((t) =>
-        currentTeamId === t.id
-          ? { value: t.id, label: `${t.key} - ${t.name}`, hint: "current" as const }
-          : { value: t.id, label: `${t.key} - ${t.name}` },
-      ),
-      { value: CREATE_NEW, label: "Create new team..." },
-    ];
+    const teamOptions: Array<{ value: TeamId | typeof CREATE_NEW; label: string; hint?: string }> =
+      [
+        ...teams.map((t) =>
+          currentTeamId === t.id
+            ? { value: t.id, label: `${t.key} - ${t.name}`, hint: "current" as const }
+            : { value: t.id, label: `${t.key} - ${t.name}` },
+        ),
+        { value: CREATE_NEW, label: "Create new team..." },
+      ];
 
     const teamChoice = yield* Effect.tryPromise({
       try: () =>

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"}