@ship-cli/core 0.0.1

package/src/ports/IssueRepository.ts

@@ -0,0 +1,69 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import type {
+  CreateTaskInput,
+  Task,
+  TaskFilter,
+  TaskId,
+  TeamId,
+  UpdateTaskInput,
+  ProjectId,
+} from "../domain/Task.js";
+import type { LinearApiError, TaskError, TaskNotFoundError } from "../domain/Errors.js";
+
+export interface IssueRepository {
+  /** Get a task by its Linear ID */
+  readonly getTask: (id: TaskId) => Effect.Effect<Task, TaskNotFoundError | LinearApiError>;
+
+  /** Get a task by its identifier (e.g., "ENG-123") */
+  readonly getTaskByIdentifier: (
+    identifier: string,
+  ) => Effect.Effect<Task, TaskNotFoundError | LinearApiError>;
+
+  /** Create a new task */
+  readonly createTask: (
+    teamId: TeamId,
+    input: CreateTaskInput,
+  ) => Effect.Effect<Task, TaskError | LinearApiError>;
+
+  /** Update an existing task */
+  readonly updateTask: (
+    id: TaskId,
+    input: UpdateTaskInput,
+  ) => Effect.Effect<Task, TaskNotFoundError | TaskError | LinearApiError>;
+
+  /** List tasks with optional filters */
+  readonly listTasks: (
+    teamId: TeamId,
+    filter: TaskFilter,
+  ) => Effect.Effect<ReadonlyArray<Task>, LinearApiError>;
+
+  /** Get tasks that are ready to work on (not blocked) */
+  readonly getReadyTasks: (
+    teamId: TeamId,
+    projectId?: ProjectId,
+  ) => Effect.Effect<ReadonlyArray<Task>, LinearApiError>;
+
+  /** Get tasks that are blocked by other tasks */
+  readonly getBlockedTasks: (
+    teamId: TeamId,
+    projectId?: ProjectId,
+  ) => Effect.Effect<ReadonlyArray<Task>, LinearApiError>;
+
+  /** Add a blocking relationship between tasks */
+  readonly addBlocker: (
+    blockedId: TaskId,
+    blockerId: TaskId,
+  ) => Effect.Effect<void, TaskNotFoundError | TaskError | LinearApiError>;
+
+  /** Remove a blocking relationship between tasks */
+  readonly removeBlocker: (
+    blockedId: TaskId,
+    blockerId: TaskId,
+  ) => Effect.Effect<void, TaskNotFoundError | TaskError | LinearApiError>;
+
+  /** Get the suggested branch name for a task */
+  readonly getBranchName: (id: TaskId) => Effect.Effect<string, TaskNotFoundError | LinearApiError>;
+}
+
+export const IssueRepository = Context.GenericTag<IssueRepository>("IssueRepository");

package/src/ports/PrService.ts

@@ -0,0 +1,52 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import type { GhNotInstalledError, PrError } from "../domain/Errors.js";
+
+// === PR Domain Types ===
+
+export const PrId = Schema.String.pipe(Schema.brand("PrId"));
+export type PrId = typeof PrId.Type;
+
+export class PullRequest extends Schema.Class<PullRequest>("PullRequest")({
+  id: PrId,
+  number: Schema.Number,
+  title: Schema.String,
+  url: Schema.String,
+  state: Schema.Literal("open", "closed", "merged"),
+  head: Schema.String,
+  base: Schema.String,
+}) {}
+
+export class CreatePrInput extends Schema.Class<CreatePrInput>("CreatePrInput")({
+  title: Schema.String,
+  body: Schema.String,
+  head: Schema.String, // branch name
+  base: Schema.optionalWith(Schema.String, { default: () => "main" }),
+}) {}
+
+export interface PrService {
+  /**
+   * Check if gh CLI is available
+   */
+  readonly isAvailable: () => Effect.Effect<boolean, never>;
+
+  /**
+   * Create a new pull request
+   */
+  readonly createPr: (
+    input: CreatePrInput,
+  ) => Effect.Effect<PullRequest, GhNotInstalledError | PrError>;
+
+  /**
+   * Open PR URL in browser
+   */
+  readonly openInBrowser: (url: string) => Effect.Effect<void, PrError>;
+
+  /**
+   * Get PR by branch name
+   */
+  readonly getPrByBranch: (branch: string) => Effect.Effect<PullRequest | null, PrError>;
+}
+
+export class PrService extends Context.Tag("PrService")<PrService, PrService>() {}

package/src/ports/ProjectRepository.ts

@@ -0,0 +1,19 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import type { Project, TeamId } from "../domain/Task.js";
+import type { LinearApiError, TaskError } from "../domain/Errors.js";
+
+export interface CreateProjectInput {
+  readonly name: string;
+  readonly description?: string;
+}
+
+export interface ProjectRepository {
+  readonly getProjects: (teamId: TeamId) => Effect.Effect<ReadonlyArray<Project>, LinearApiError>;
+  readonly createProject: (
+    teamId: TeamId,
+    input: CreateProjectInput,
+  ) => Effect.Effect<Project, TaskError | LinearApiError>;
+}
+
+export const ProjectRepository = Context.GenericTag<ProjectRepository>("ProjectRepository");

package/src/ports/TeamRepository.ts

@@ -0,0 +1,17 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import type { Team, TeamId } from "../domain/Task.js";
+import type { LinearApiError, TaskError } from "../domain/Errors.js";
+
+export interface CreateTeamInput {
+  readonly name: string;
+  readonly key: string;
+}
+
+export interface TeamRepository {
+  readonly getTeams: () => Effect.Effect<ReadonlyArray<Team>, LinearApiError>;
+  readonly getTeam: (id: TeamId) => Effect.Effect<Team, LinearApiError>;
+  readonly createTeam: (input: CreateTeamInput) => Effect.Effect<Team, TaskError | LinearApiError>;
+}
+
+export const TeamRepository = Context.GenericTag<TeamRepository>("TeamRepository");

package/src/ports/VcsService.ts

@@ -0,0 +1,87 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import type { JjNotInstalledError, VcsError } from "../domain/Errors.js";
+
+// === VCS Domain Types ===
+
+export const ChangeId = Schema.String.pipe(Schema.brand("ChangeId"));
+export type ChangeId = typeof ChangeId.Type;
+
+export class Change extends Schema.Class<Change>("Change")({
+  id: ChangeId,
+  changeId: Schema.String, // Short change id
+  description: Schema.String,
+  author: Schema.String,
+  timestamp: Schema.Date,
+  bookmarks: Schema.Array(Schema.String),
+  isWorkingCopy: Schema.Boolean,
+  isEmpty: Schema.Boolean,
+}) {}
+
+export class PushResult extends Schema.Class<PushResult>("PushResult")({
+  bookmark: Schema.String,
+  remote: Schema.String,
+  changeId: ChangeId,
+}) {}
+
+export interface VcsService {
+  /**
+   * Check if jj is available
+   */
+  readonly isAvailable: () => Effect.Effect<boolean, never>;
+
+  /**
+   * Check if current directory is a jj repo
+   */
+  readonly isRepo: () => Effect.Effect<boolean, VcsError>;
+
+  /**
+   * Create a new change (jj new)
+   */
+  readonly createChange: (
+    message: string,
+  ) => Effect.Effect<ChangeId, JjNotInstalledError | VcsError>;
+
+  /**
+   * Describe/update current change message
+   */
+  readonly describe: (message: string) => Effect.Effect<void, VcsError>;
+
+  /**
+   * Commit (jj commit) - creates new empty change on top
+   */
+  readonly commit: (message: string) => Effect.Effect<ChangeId, VcsError>;
+
+  /**
+   * Create a bookmark at current change
+   */
+  readonly createBookmark: (name: string, ref?: ChangeId) => Effect.Effect<void, VcsError>;
+
+  /**
+   * Push bookmark to remote
+   */
+  readonly push: (bookmark: string) => Effect.Effect<PushResult, VcsError>;
+
+  /**
+   * Get current change
+   */
+  readonly getCurrentChange: () => Effect.Effect<Change, VcsError>;
+
+  /**
+   * Get the stack of changes (from main to current)
+   */
+  readonly getStack: () => Effect.Effect<ReadonlyArray<Change>, VcsError>;
+
+  /**
+   * Get log of changes
+   */
+  readonly getLog: (revset?: string) => Effect.Effect<ReadonlyArray<Change>, VcsError>;
+
+  /**
+   * Fetch from remote
+   */
+  readonly fetch: () => Effect.Effect<void, VcsError>;
+}
+
+export class VcsService extends Context.Tag("VcsService")<VcsService, VcsService>() {}

package/src/ports/index.ts

@@ -0,0 +1,7 @@
+export * from "./TeamRepository.js";
+export * from "./ProjectRepository.js";
+export * from "./IssueRepository.js";
+export * from "./AuthService.js";
+export * from "./ConfigRepository.js";
+export * from "./VcsService.js";
+export * from "./PrService.js";

package/test/Dummy.test.ts

@@ -0,0 +1,7 @@
+import { describe, expect, it } from "@effect/vitest"
+
+describe("Dummy", () => {
+  it("should pass", () => {
+    expect(true).toBe(true)
+  })
+})

package/tsconfig.base.json

@@ -0,0 +1,45 @@
+{
+  "include": [],
+  "compilerOptions": {
+    "strict": true,
+    "moduleDetection": "force",
+    "composite": true,
+    "downlevelIteration": true,
+    "resolveJsonModule": true,
+    "esModuleInterop": false,
+    "declaration": true,
+    "skipLibCheck": true,
+    "exactOptionalPropertyTypes": true,
+    "emitDecoratorMetadata": false,
+    "experimentalDecorators": true,
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022", "DOM"],
+    "isolatedModules": true,
+    "sourceMap": true,
+    "declarationMap": true,
+    "noImplicitReturns": false,
+    "noUnusedLocals": true,
+    "noUnusedParameters": false,
+    "noFallthroughCasesInSwitch": true,
+    "noEmitOnError": false,
+    "noErrorTruncation": false,
+    "allowJs": false,
+    "checkJs": false,
+    "forceConsistentCasingInFileNames": true,
+    "stripInternal": true,
+    "noImplicitAny": true,
+    "noImplicitThis": true,
+    "noUncheckedIndexedAccess": false,
+    "strictNullChecks": true,
+    "baseUrl": ".",
+    "target": "ES2022",
+    "module": "NodeNext",
+    "incremental": true,
+    "removeComments": false,
+    "plugins": [{ "name": "@effect/language-service" }],
+    "paths": {
+      "@ship/cli": ["./src/index.js"],
+      "@ship/cli/*": ["./src/*.js"]
+    }
+  }
+}

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./tsconfig.base.json",
+  "references": [
+    { "path": "tsconfig.src.json" },
+    { "path": "tsconfig.test.json" }
+  ]
+}

package/tsconfig.src.json

@@ -0,0 +1,11 @@
+{
+  "extends": "./tsconfig.base.json",
+  "include": ["src"],
+  "compilerOptions": {
+    "types": ["node"],
+    "tsBuildInfoFile": ".tsbuildinfo/src.tsbuildinfo",
+    "rootDir": "src",
+    "outDir": "dist",
+    "noEmit": true
+  }
+}

package/tsconfig.test.json

@@ -0,0 +1,10 @@
+{
+  "extends": "./tsconfig.base.json",
+  "include": ["test"],
+  "compilerOptions": {
+    "types": ["node"],
+    "tsBuildInfoFile": ".tsbuildinfo/test.tsbuildinfo",
+    "rootDir": "test",
+    "noEmit": true
+  }
+}

package/tsup.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from "tsup"
+
+export default defineConfig({
+  entry: ["src/bin.ts"],
+  outDir: "dist",
+  format: ["esm"],
+  clean: true,
+  treeshake: "smallest",
+  noExternal: [/.*/],
+  external: ["@parcel/watcher"],
+  banner: {
+    js: `import { createRequire } from 'module'; const require = createRequire(import.meta.url);`
+  }
+})

package/vitest.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from "vitest/config"
+
+export default defineConfig({
+  test: {
+    include: ["./test/**/*.test.{js,mjs,cjs,ts,mts,cts,jsx,tsx}"],
+    exclude: [],
+    globals: true,
+    coverage: {
+      provider: "v8"
+    }
+  }
+})