@coldic3/slipway 1.0.0

package/docker/compose.yaml

@@ -0,0 +1,29 @@
+# Slipway's optional Docker runtime (`slipway up --docker`, ADR 0002). Run it through the slipway CLI: it generates the
+# settings env file and the branding copy, and passes these variables:
+#   SLIPWAY_PROJECT       compose project name (default: slipway)
+#   SLIPWAY_PORT          host port, bound to 127.0.0.1 only (security invariant)
+#   SLIPWAY_GITEA_ENV     generated GITEA__section__KEY settings (src/runtime/settings.ts)
+#   SLIPWAY_GITEA_CUSTOM  Slipway's Gitea branding (a copy in ~/.slipway/gitea/custom)
+name: ${SLIPWAY_PROJECT:-slipway}
+
+services:
+  gitea:
+    image: gitea/gitea:28.3.0-rootless
+    restart: unless-stopped
+    ports:
+      - "127.0.0.1:${SLIPWAY_PORT:?run this through slipway up --docker}:3000"
+    env_file:
+      - ${SLIPWAY_GITEA_ENV:?run this through slipway up --docker}
+    volumes:
+      - gitea-data:/var/lib/gitea
+      - ${SLIPWAY_GITEA_CUSTOM:?run this through slipway up --docker}:/var/lib/gitea/custom:ro
+      - gitea-config:/etc/gitea
+    healthcheck:
+      test: ["CMD", "curl", "-fsS", "http://localhost:3000/api/healthz"]
+      interval: 5s
+      timeout: 3s
+      retries: 30
+
+volumes:
+  gitea-data:
+  gitea-config:

package/gitea/public/assets/css/slipway.css

@@ -0,0 +1,75 @@
+/* Slipway palette on top of gitea-dark: neutral dark gray + amber accent (ADR 0001). */
+:root {
+  --dd-gray-950: #141517;
+  --dd-gray-900: #1b1d20;
+  --dd-gray-850: #222428;
+  --dd-gray-800: #2a2d31;
+  --dd-gray-700: #3a3d42;
+  --dd-ink: #eceef1;
+  --dd-ink-muted: #a9aeb5;
+  --dd-amber: #f2a43a;
+  --dd-amber-dark: #d98a1f;
+
+  --color-body: var(--dd-gray-900);
+  --color-box-body: var(--dd-gray-850);
+  --color-box-body-highlight: var(--dd-gray-800);
+  --color-box-header: var(--dd-gray-800);
+  --color-nav-bg: var(--dd-gray-950);
+  --color-nav-hover-bg: var(--dd-gray-800);
+  --color-header-wrapper: var(--dd-gray-900);
+  --color-footer: var(--dd-gray-950);
+  --color-secondary: var(--dd-gray-700);
+  --color-secondary-bg: var(--dd-gray-850);
+  --color-input-background: var(--dd-gray-950);
+  --color-input-border: var(--dd-gray-700);
+  --color-menu: var(--dd-gray-850);
+  --color-card: var(--dd-gray-850);
+  --color-text: var(--dd-ink);
+  --color-text-light: var(--dd-ink-muted);
+  --color-primary: var(--dd-amber);
+  --color-primary-contrast: var(--dd-gray-950);
+  --color-primary-dark-1: var(--dd-amber-dark);
+  --color-primary-light-1: #f5b65f;
+  --color-primary-alpha-20: rgba(242, 164, 58, 0.2);
+  --color-primary-alpha-30: rgba(242, 164, 58, 0.3);
+  --color-accent: var(--dd-amber);
+}
+
+/* Navigation: only Slipway's things (Pull requests, Repositories, user menu). */
+#navbar a.item[href$="/explore/repos"]:not(.slipway-repos-link),
+#navbar a.item[href$="/milestones"],
+#navbar a.item[href$="/issues"],
+#navbar a.item[href$="/explore/organizations"],
+#navbar a.item[href="https://docs.gitea.com"],
+#navbar a.item[href$="/notifications"],
+#navbar .item[data-tooltip-content="Create…"],
+#navbar .item[data-tooltip-content="Create..."],
+#navbar a.item[href$="/repo/create"],
+#navbar a.item[href$="/repo/migrate"],
+#navbar a.item[href$="/org/create"],
+.user-menu a.item[href$="?tab=stars"],
+.user-menu a.item[href*="docs.gitea.com"] { display: none !important; }
+
+/* Sign-in page (style A). */
+.slipway-signin { background: var(--dd-gray-900); min-height: 100%; }
+.slipway-hero { text-align: center; color: var(--dd-ink); padding-top: 2rem; }
+.slipway-hero h1 { margin: 0.5rem 0 0.25rem; font-size: 2rem; letter-spacing: 0.02em; color: var(--dd-ink); }
+.slipway-hero p { margin: 0; color: var(--dd-ink-muted); }
+.slipway-signin .ui.attached.segment, .slipway-signin .ui.top.attached.header { background: var(--dd-gray-850); border-color: var(--dd-gray-700); }
+.slipway-signin .ui.primary.button { background: var(--dd-amber); color: var(--dd-gray-950); font-weight: 700; }
+
+/* PR page: the merge box only keeps Slipway's note. */
+.pull-merge-box .merge-section > .item:not(.slipway-promote-note) { display: none !important; }
+.slipway-promote-note { color: var(--dd-ink-muted); }
+
+.slipway-footer { color: var(--dd-ink-muted); }
+
+/* Sign-in: no password reset (mail is off), no duplicate "Sign In" in the top bar. Passkeys are off in app.ini. */
+.slipway-signin a[href$="/user/forgot_password"],
+#navbar a.item[href$="/user/login"] { display: none !important; }
+
+/* "Repositories" (explore) page: only the repo list, no users/organizations tabs. */
+.page-content.explore .explore-tabs a.item[href$="/explore/users"],
+.page-content.explore .explore-tabs a.item[href$="/explore/organizations"],
+.page-content.explore a.item[href$="/explore/users"],
+.page-content.explore a.item[href$="/explore/organizations"] { display: none !important; }

package/gitea/public/assets/img/favicon.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" class="slipway-logo">
+  <rect width="64" height="64" rx="14" fill="#1b1d20"/>
+  <g transform="translate(4 3) scale(0.875)">
+  <!-- hull resting on dock blocks -->
+  <path d="M6 29 H58 L50.5 42 H13.5 Z" fill="#f2a43a"/>
+  <rect x="21" y="16" width="22" height="13" rx="2.5" fill="#e8f1fb"/>
+  <rect x="25" y="19.5" width="4" height="4" rx="1" fill="#2a2d31"/>
+  <rect x="35" y="19.5" width="4" height="4" rx="1" fill="#2a2d31"/>
+  <rect x="12" y="45" width="8" height="8" rx="1" fill="#9aa1aa"/>
+  <rect x="28" y="45" width="8" height="8" rx="1" fill="#9aa1aa"/>
+  <rect x="44" y="45" width="8" height="8" rx="1" fill="#9aa1aa"/>
+  <path d="M3 56 H61" stroke="#9aa1aa" stroke-width="3" stroke-linecap="round"/>
+  </g>
+</svg>

package/gitea/public/assets/img/logo.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" class="slipway-logo" role="img" aria-label="Slipway">
+  <title>Slipway</title>
+  <!-- hull resting on dock blocks -->
+  <path d="M6 29 H58 L50.5 42 H13.5 Z" fill="#f2a43a"/>
+  <rect x="21" y="16" width="22" height="13" rx="2.5" fill="#e8f1fb"/>
+  <rect x="25" y="19.5" width="4" height="4" rx="1" fill="#2a2d31"/>
+  <rect x="35" y="19.5" width="4" height="4" rx="1" fill="#2a2d31"/>
+  <rect x="12" y="45" width="8" height="8" rx="1" fill="#9aa1aa"/>
+  <rect x="28" y="45" width="8" height="8" rx="1" fill="#9aa1aa"/>
+  <rect x="44" y="45" width="8" height="8" rx="1" fill="#9aa1aa"/>
+  <path d="M3 56 H61" stroke="#9aa1aa" stroke-width="3" stroke-linecap="round"/>
+</svg>

package/gitea/public/assets/js/slipway-head.js

@@ -0,0 +1,8 @@
+// Slipway: signed-in visitors of the home page go straight to the pull request list.
+(function () {
+  var signed = document.querySelector('meta[name="slipway-signed-in"]');
+  var sub = (document.querySelector('meta[name="slipway-sub-url"]') || {}).content || '';
+  if (signed && signed.content === '1' && (location.pathname === sub + '/' || location.pathname === sub)) {
+    location.replace(sub + '/pulls');
+  }
+})();

package/gitea/public/assets/js/slipway.js

@@ -0,0 +1,13 @@
+// Slipway: the merge box in a PR is replaced by a short note (merging happens on GitHub after promotion).
+(function () {
+  function addNote() {
+    const box = document.querySelector('.pull-merge-box .merge-section');
+    if (!box || box.querySelector('.slipway-promote-note')) return;
+    const note = document.createElement('div');
+    note.className = 'item slipway-promote-note';
+    note.textContent = 'Approved PRs are promoted to GitHub from your Claude session.';
+    box.prepend(note);
+  }
+  addNote();
+  new MutationObserver(addNote).observe(document.body, { childList: true, subtree: true });
+})();

package/gitea/templates/base/footer_content.tmpl

@@ -0,0 +1,4 @@
+<footer class="page-footer slipway-footer" role="group" aria-label="Footer">
+	<div class="left-links">Slipway · local review for AI pull requests</div>
+	<div class="right-links"></div>
+</footer>

package/gitea/templates/custom/extra_links.tmpl

@@ -0,0 +1 @@
+{{if .IsSigned}}<a class="item slipway-repos-link{{if .PageIsExplore}} active{{end}}" href="{{AppSubUrl}}/explore/repos">Repositories</a>{{end}}

package/gitea/templates/custom/footer.tmpl

@@ -0,0 +1 @@
+<script src="{{AssetUrlPrefix}}/js/slipway.js?v=f190837090" defer></script>

package/gitea/templates/custom/header.tmpl

@@ -0,0 +1,5 @@
+{{/* Slipway branding (ADR 0001): palette + trimmed UI, and signed-in home → the PR list. Inline scripts are blocked by CSP. */}}
+<link rel="stylesheet" href="{{AssetUrlPrefix}}/css/slipway.css?v=e13e51a4ea">
+<meta name="slipway-signed-in" content="{{if .IsSigned}}1{{else}}0{{end}}">
+<meta name="slipway-sub-url" content="{{AppSubUrl}}">
+<script src="{{AssetUrlPrefix}}/js/slipway-head.js?v=3519157e92"></script>

package/gitea/templates/user/auth/signin.tmpl

@@ -0,0 +1,14 @@
+{{template "base/head" .}}
+<div role="main" aria-label="{{.Title}}" class="page-content user signin slipway-signin{{if .LinkAccountMode}} icon{{end}}">
+	<div class="ui middle very relaxed page grid">
+		<div class="column tw-flex tw-flex-col tw-gap-4 tw-max-w-2xl tw-m-auto">
+			<div class="slipway-hero">
+				<img src="{{AssetUrlPrefix}}/img/logo.svg" width="72" height="72" alt="">
+				<h1>Slipway</h1>
+				<p>Review AI pull requests, then launch them to GitHub</p>
+			</div>
+			{{template "user/auth/signin_inner" .}}
+		</div>
+	</div>
+</div>
+{{template "base/footer" .}}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@coldic3/slipway",
+  "version": "1.0.0",
+  "description": "A local review station for AI-agent pull requests: review in a local Gitea, promote the approved commits to GitHub",
+  "keywords": [
+    "ai",
+    "code-review",
+    "pull-requests",
+    "gitea",
+    "github",
+    "claude-code",
+    "mcp"
+  ],
+  "homepage": "https://github.com/coldic3/slipway#readme",
+  "bugs": {
+    "url": "https://github.com/coldic3/slipway/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/coldic3/slipway.git"
+  },
+  "license": "MIT",
+  "author": "Kevin Kaniaburka",
+  "type": "module",
+  "bin": {
+    "slipway": "dist/slipway.mjs"
+  },
+  "files": [
+    "dist/slipway.mjs",
+    "gitea/",
+    "docker/compose.yaml"
+  ],
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "slipway": "tsx src/cli.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run test:unit && npm run test:functional",
+    "test:unit": "vitest run tests/unit",
+    "test:functional": "vitest run tests/functional",
+    "test:e2e": "playwright test",
+    "test:all": "npm test && npm run test:e2e",
+    "build:plugin": "node scripts/build-plugin.mjs",
+    "build:brand": "node scripts/build-brand.mjs && node scripts/stamp-assets.mjs",
+    "build": "npm run build:cli && npm run build:plugin",
+    "build:cli": "node scripts/build-cli.mjs",
+    "prepack": "npm run build:cli"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.2",
+    "@playwright/test": "^1.65.0",
+    "@types/node": "^26.6.6",
+    "esbuild": "^0.28.2",
+    "tsx": "^4.23.15",
+    "typescript": "^5.9.3",
+    "vitest": "^5.1.0",
+    "zod": "^4.6.7"
+  }
+}