chore cleanp

refactor canonical components and remove slice 1
flue refactor and migrations
2026-07-29 01:24:37 +05:30 · 2026-07-29 01:24:16 +05:30 · 2026-07-29 00:45:46 +05:30 · 2026-07-29 00:45:33 +05:30 · 2026-07-28 22:20:42 +05:30 · 2026-07-28 20:08:46 +05:30
42 changed files with 22791 additions and 6036 deletions
--- a/.npmrc
+++ b/.npmrc
@@ -0,0 +1 @@
 verify-deps-before-run=false
--- a/apps/web/src/components/slice-one/slice-one-page.tsx
+++ b/apps/web/src/components/slice-one/slice-one-page.tsx
@@ -1,887 +0,0 @@
 import { projectWorkNotices } from "@code/primitives/work";
 import {
  Conversation,
  ConversationContent,
 } from "@code/ui/components/ai-elements/conversation";
 import { Button } from "@code/ui/components/button";
 import {
  AlertTriangle,
  ChevronRight,
  Check,
  FileCode2,
  FolderGit2,
  Hammer,
  LoaderCircle,
  Menu,
  MessageSquareText,
  ImagePlus,
  Play,
  RotateCcw,
  ScrollText,
  Send,
  Sparkles,
  Settings,
  X,
 } from "lucide-react";
 import { useMemo, useRef, useState } from "react";
 import { PendingChatAttachments } from "@/components/chat/chat-attachments";
 import { ChatMessage } from "@/components/chat/chat-message";
 import { ChatThinkingResponse } from "@/components/chat/chat-thinking-response";
 import { useChatImages } from "@/hooks/chat/use-chat-images";
 import { useSliceOne } from "@/hooks/slice-one/use-slice-one";
 import { useVisualViewportStyle } from "@/hooks/slice-one/use-visual-viewport";
 import {
  buildSliceOneTimeline,
  findSourceMessageTarget,
 } from "@/lib/slice-one/presentation";
 type SliceWork = NonNullable<ReturnType<typeof useSliceOne>["works"]>[number];
 const EMPTY_WORKS: readonly SliceWork[] = [];
 type SliceArtifact = NonNullable<
  NonNullable<SliceWork["runs"][number]["artifacts"]>[number]
 >;
 interface ArtifactMetadata {
  readonly changedFiles?: readonly string[];
 }
 const parseArtifactMetadata = (artifact: SliceArtifact): ArtifactMetadata => {
  if (!artifact.metadataJson) {
    return {};
  }
  try {
    return JSON.parse(artifact.metadataJson) as ArtifactMetadata;
  } catch {
    return {};
  }
 };
 const changedFilesFor = (artifact: SliceArtifact): readonly string[] =>
  parseArtifactMetadata(artifact).changedFiles ?? [];
 interface WorkCardProps {
  readonly onSourceSelect: (rawText: string) => void;
  readonly work: SliceWork;
  readonly slice: SliceOneState;
 }
 const starterDefinition = (work: SliceWork) => ({
  acceptanceCriteria: ["The requested outcome is observable and documented"],
  affectedUsers: ["Project users"],
  assumptions: [],
  constraints: [],
  desiredOutcome: work.objective,
  inScope: [work.objective],
  outOfScope: ["Unrelated product changes"],
  problem: work.objective,
  questions: [],
  requiredArtifacts: ["Simulation activity and terminal outcome"],
  risk: "medium",
 });
 const starterDesign = (work: SliceWork) => ({
  architectureSummary:
    "Validate the approved Definition, then exercise one deterministic fake slice.",
  callFlowDelta: [
    "Work -> Run -> Attempt -> normalized events -> terminal outcome",
  ],
  concerns: [],
  evidenceRequirements: ["Terminal Run classification"],
  fileTreeDelta: [],
  impactMap: {
    files: [],
    modules: [],
    risks: [],
    summary: "Compact vertical-slice simulation",
  },
  invariants: [
    "Simulation never claims implementation",
    "Every Attempt reaches a terminal classification",
  ],
  keyInterfaces: ["HarnessRuntime", "AttemptOutcome"],
  slices: [
    {
      codeBoundaries: ["workExecution"],
      dependsOn: [],
      evidenceRequirements: ["Normalized activity events"],
      id: "slice-1",
      objective: work.objective,
      observableBehavior: "A terminal fake Run is visible",
      reviewRequired: false,
      title: "Deterministic simulation",
      verification: ["Run completes with a terminal classification"],
    },
  ],
  tradeoffs: ["Fake runtime proves contract before sandbox integration"],
 });
 // oxlint-disable-next-line complexity -- the expanded card intentionally keeps the three review sections together.
 const WorkCard = ({ onSourceSelect, work, slice }: WorkCardProps) => {
  const [sourcesOpen, setSourcesOpen] = useState(false);
  const [expanded, setExpanded] = useState(false);
  const [logsOpen, setLogsOpen] = useState(false);
  const sources = work.signals.flatMap((signal) => signal.sources);
  const { definition } = work;
  const { design } = work;
  const [latestRun] = work.runs;
  return (
    <article className="border border-[#d7d3c7] bg-[#fffefa] p-4 text-[#20201d] shadow-[0_10px_30px_rgba(30,30,20,0.06)]">
      <div className="flex items-start gap-3">
        <span className="grid size-8 shrink-0 place-items-center bg-[#dcff68]">
          <Sparkles className="size-4" />
        </span>
        <div className="min-w-0 flex-1">
          <p className="text-[10px] font-semibold uppercase text-[#65713a]">
            Proposed Work
          </p>
          <h2 className="mt-1 text-[15px] font-semibold leading-5">
            {work.title}
          </h2>
          <p className="mt-1.5 text-[13px] leading-5 text-[#626057]">
            {work.objective}
          </p>
        </div>
      </div>
      <button
        className="mt-3 flex w-full items-center justify-between border-t border-[#e7e3d9] pt-3 text-left text-xs text-[#69675e]"
        onClick={() => setSourcesOpen((open) => !open)}
        type="button"
      >
        <span>
          {sources.length} exact source{" "}
          {sources.length === 1 ? "message" : "messages"}
        </span>
        <ChevronRight
          className={`size-4 transition-transform ${sourcesOpen ? "rotate-90" : ""}`}
        />
      </button>
      <button
        className="mt-2 flex w-full items-center justify-between border-t border-[#e7e3d9] pt-3 text-left text-xs font-medium text-[#20201d]"
        onClick={() => setExpanded((open) => !open)}
        type="button"
      >
        <span>{expanded ? "Hide Work details" : "Open Work details"}</span>
        <ChevronRight
          className={`size-4 transition-transform ${expanded ? "rotate-90" : ""}`}
        />
      </button>
      {sourcesOpen ? (
        <div className="mt-3 space-y-2">
          {sources.map((source) => (
            <button
              className="flex w-full items-start gap-2 border-l-2 border-[#a8b750] bg-[#f4f2e9] px-3 py-2 text-left text-xs leading-5 hover:bg-[#ece9dd]"
              key={source.messageId}
              onClick={() => onSourceSelect(source.rawText)}
              type="button"
            >
              <MessageSquareText className="mt-1 size-3.5 shrink-0 text-[#65713a]" />
              <span className="min-w-0 flex-1">{source.rawText}</span>
            </button>
          ))}
        </div>
      ) : null}
      {expanded ? (
        <div className="mt-4 space-y-4 border-t border-[#e7e3d9] pt-4 text-xs">
          <section>
            <p className="font-semibold uppercase tracking-wide text-[#65713a]">
              Outcome
            </p>
            <p className="mt-1 leading-5 text-[#626057]">{work.objective}</p>
            <p className="mt-2 text-[#747168]">
              Risk: {definition?.risk ?? "not defined"}
            </p>
            {definition?.questions?.length ? (
              <p className="mt-1 text-amber-800">
                {
                  definition.questions.filter(
                    (question) => question.status === "open"
                  ).length
                }{" "}
                open question(s)
              </p>
            ) : null}
            <div className="mt-2 flex flex-wrap gap-2">
              {work.status === "proposed" ? (
                <Button
                  size="sm"
                  onClick={() => void slice.requestDefinition(work._id)}
                >
                  <Sparkles className="size-3.5" /> Define
                </Button>
              ) : null}
              {work.status === "defining" ? (
                <Button
                  size="sm"
                  variant="outline"
                  onClick={() =>
                    void slice.saveDefinition(work._id, starterDefinition(work))
                  }
                >
                  <Hammer className="size-3.5" /> Save definition
                </Button>
              ) : null}
              {work.status === "awaiting-definition-approval" &&
              work.definitionVersion ? (
                <Button
                  size="sm"
                  onClick={() =>
                    void slice.approveDefinition(
                      work._id,
                      work.definitionVersion as number
                    )
                  }
                >
                  <Check className="size-3.5" /> Approve
                </Button>
              ) : null}
            </div>
          </section>
          <section>
            <p className="font-semibold uppercase tracking-wide text-[#65713a]">
              Design
            </p>
            <p className="mt-1 leading-5 text-[#626057]">
              {design?.architectureSummary ?? "No Design Packet yet."}
            </p>
            {design?.slices?.map((item) => (
              <p className="mt-1 text-[#747168]" key={item.id}>
                {item.title}: {item.observableBehavior}
              </p>
            ))}
            <div className="mt-2 flex flex-wrap gap-2">
              {work.status === "designing" ? (
                <Button
                  size="sm"
                  variant="outline"
                  onClick={() =>
                    void slice.saveDesign(work._id, starterDesign(work))
                  }
                >
                  <Hammer className="size-3.5" /> Save design
                </Button>
              ) : null}
              {work.status === "awaiting-design-approval" &&
              work.definitionApprovalVersion &&
              work.designVersion ? (
                <Button
                  size="sm"
                  onClick={() =>
                    void slice.approveDesign(
                      work._id,
                      work.definitionApprovalVersion as number,
                      work.designVersion as number
                    )
                  }
                >
                  <Check className="size-3.5" /> Approve design
                </Button>
              ) : null}
            </div>
          </section>
          <section>
            <p className="font-semibold uppercase tracking-wide text-[#65713a]">
              Build
            </p>
            {slice.operationError ? (
              <p className="mt-2 flex items-start gap-1.5 border border-red-300 bg-red-50 px-2 py-1.5 text-red-800">
                <AlertTriangle className="mt-0.5 size-3.5 shrink-0" />
                <span className="min-w-0 flex-1 leading-5">
                  {slice.operationError.message}
                </span>
                <button
                  aria-label="Dismiss error"
                  className="shrink-0"
                  onClick={() => slice.clearOperationError()}
                  type="button"
                >
                  <X className="size-3.5" />
                </button>
              </p>
            ) : null}
            {latestRun ? (
              <div className="mt-1 space-y-2 text-[#626057]">
                <p className="leading-5">
                  {latestRun.executionKind === "real"
                    ? "AgentOS"
                    : "Simulation"}{" "}
                  run {latestRun.status}:{" "}
                  {latestRun.terminalSummary ??
                    latestRun.terminalClassification ??
                    "activity is still arriving"}
                </p>
                {latestRun.baseRevision ? (
                  <p className="font-mono text-[10px] text-[#747168]">
                    {latestRun.baseRevision.slice(0, 8)} →{" "}
                    {latestRun.candidateRevision?.slice(0, 8) ?? "working"}
                  </p>
                ) : null}
                {latestRun.artifacts?.map((artifact) => {
                  const changedFiles = changedFilesFor(artifact);
                  return (
                    <div key={artifact._id} className="space-y-1">
                      {artifact.uri ? (
                        <a
                          className="block font-medium underline"
                          href={artifact.uri}
                          rel="noreferrer"
                          target="_blank"
                        >
                          {artifact.title}
                        </a>
                      ) : (
                        <p className="font-medium">{artifact.title}</p>
                      )}
                      {changedFiles.length > 0 ? (
                        <ul className="space-y-0.5">
                          {changedFiles.map((file) => (
                            <li
                              className="flex items-start gap-1.5 font-mono text-[11px] leading-5 text-[#747168]"
                              key={file}
                            >
                              <FileCode2 className="mt-0.5 size-3 shrink-0 text-[#9a985f]" />
                              <span className="min-w-0 break-all">{file}</span>
                            </li>
                          ))}
                        </ul>
                      ) : null}
                    </div>
                  );
                })}
                {latestRun.attemptEvents &&
                latestRun.attemptEvents.length > 0 ? (
                  <div className="space-y-1">
                    {(logsOpen
                      ? latestRun.attemptEvents
                      : latestRun.attemptEvents.slice(-3)
                    ).map((item) => (
                      <p
                        className="border-l-2 border-[#b8c760] pl-2 leading-5"
                        key={item._id}
                      >
                        {item.message}
                      </p>
                    ))}
                    {latestRun.attemptEvents.length > 3 ? (
                      <button
                        className="flex items-center gap-1 font-medium text-[#65713a] hover:underline"
                        onClick={() => setLogsOpen((open) => !open)}
                        type="button"
                      >
                        <ScrollText className="size-3.5" />
                        {logsOpen
                          ? "Show recent activity"
                          : `Show full activity log (${latestRun.attemptEvents.length})`}
                        <ChevronRight
                          className={`size-3.5 transition-transform ${logsOpen ? "rotate-90" : ""}`}
                        />
                      </button>
                    ) : null}
                  </div>
                ) : null}
              </div>
            ) : (
              <p className="mt-1 text-[#747168]">No implementation Run yet.</p>
            )}
            <div className="mt-2 flex flex-wrap gap-2">
              {work.status === "ready" ? (
                <Button
                  size="sm"
                  disabled={!slice.projectGitConnection}
                  onClick={() => void slice.startExecution(work._id)}
                >
                  <Play className="size-3.5" /> Run
                </Button>
              ) : null}
              {work.status === "ready" ? (
                <Button
                  size="sm"
                  variant="outline"
                  onClick={() =>
                    void slice.startSimulation(work._id, "success")
                  }
                >
                  <Play className="size-3.5" /> Simulate
                </Button>
              ) : null}
              {latestRun?.status === "running" ? (
                <Button
                  size="sm"
                  variant="outline"
                  onClick={() =>
                    void (latestRun.executionKind === "real"
                      ? slice.cancelExecution(latestRun._id)
                      : slice.cancelSimulation(latestRun._id))
                  }
                >
                  <X className="size-3.5" /> Cancel
                </Button>
              ) : null}
              {latestRun?.executionKind !== "real" &&
              latestRun?.status === "terminal" &&
              latestRun.terminalClassification === "RetryableFailure" ? (
                <Button
                  size="sm"
                  variant="outline"
                  onClick={() => void slice.retrySimulation(latestRun._id)}
                >
                  <RotateCcw className="size-3.5" /> Retry
                </Button>
              ) : null}
            </div>
          </section>
        </div>
      ) : null}
    </article>
  );
 };
 const ConversationLoading = () => (
  <output
    aria-label="Loading conversation"
    className="mx-auto flex min-h-[55vh] w-full max-w-md flex-col justify-center gap-4"
  >
    <span className="h-16 w-4/5 animate-pulse rounded-sm bg-[#e3e0d5]" />
    <span className="ml-auto h-12 w-3/5 animate-pulse rounded-sm bg-[#dedbd0]" />
    <span className="h-24 w-full animate-pulse rounded-sm bg-[#e3e0d5]" />
    <span className="sr-only">Loading conversation…</span>
  </output>
 );
 const ConversationEmptyState = () => (
  <div className="grid min-h-[55vh] place-items-center text-center">
    <div>
      <MessageSquareText className="mx-auto size-7 text-[#8a887f]" />
      <h1 className="mt-4 text-xl font-semibold">What should move forward?</h1>
      <p className="mx-auto mt-2 max-w-sm text-sm leading-6 text-[#69675f]">
        Describe an outcome or problem. Casual conversation stays conversation.
      </p>
    </div>
  </div>
 );
 type SliceOneState = ReturnType<typeof useSliceOne>;
 const ProjectsLoading = () => (
  <div className="grid min-h-svh place-items-center bg-[#f2f0e7]">
    <LoaderCircle className="size-5 animate-spin" />
  </div>
 );
 const ConnectProject = ({ slice }: { slice: SliceOneState }) => (
  <main className="grid min-h-svh place-items-center bg-[#f2f0e7] px-5 text-[#20201d]">
    <form
      className="w-full max-w-sm"
      onSubmit={(event) => {
        event.preventDefault();
        void slice.connectRepository();
      }}
    >
      <span className="grid size-11 place-items-center bg-[#20201d] text-white">
        <FolderGit2 className="size-5" />
      </span>
      <h1 className="mt-6 text-2xl font-semibold">Connect one project</h1>
      <p className="mt-2 text-sm leading-6 text-[#68665e]">
        Slice 1 turns actionable conversation into proposed Work with exact
        provenance.
      </p>
      <input
        aria-label="Public Git repository URL"
        className="mt-6 h-12 w-full border border-[#c9c5b9] bg-[#fffefa] px-3 text-sm outline-none focus:border-[#55564e]"
        onChange={(event) => slice.setRepository(event.target.value)}
        placeholder="https://github.com/owner/repository"
        required
        value={slice.repository}
      />
      {slice.error ? (
        <p className="mt-2 text-xs text-red-700">{slice.error.message}</p>
      ) : null}
      <Button
        className="mt-3 h-12 w-full"
        disabled={slice.pending}
        type="submit"
      >
        {slice.pending ? (
          <LoaderCircle className="size-4 animate-spin" />
        ) : null}
        {slice.pending ? "Connecting" : "Connect project"}
      </Button>
    </form>
  </main>
 );
 // oxlint-disable-next-line complexity -- this page coordinates the existing mobile shell without owning domain logic.
 export const SliceOnePage = () => {
  const slice = useSliceOne();
  const viewportStyle = useVisualViewportStyle();
  const [draft, setDraft] = useState("");
  const attachments = useChatImages();
  const imageInput = useRef<HTMLInputElement>(null);
  const [drawerOpen, setDrawerOpen] = useState(false);
  const [settingsOpen, setSettingsOpen] = useState(false);
  const [giteaUrl, setGiteaUrl] = useState("https://git.openputer.com");
  const [giteaUsername, setGiteaUsername] = useState("");
  const [giteaToken, setGiteaToken] = useState("");
  const [highlightedMessageId, setHighlightedMessageId] = useState<string>();
  const highlightTimer = useRef<ReturnType<typeof setTimeout> | null>(null);
  const works = slice.works ?? EMPTY_WORKS;
  const workById = useMemo(
    () => new Map(works.map((work) => [String(work._id), work])),
    [works]
  );
  const notices = useMemo(() => projectWorkNotices(works), [works]);
  const timeline = useMemo(
    () => buildSliceOneTimeline(slice.agent.messages, notices),
    [notices, slice.agent.messages]
  );
  const busy =
    slice.agent.status === "submitted" || slice.agent.status === "streaming";
  const revealSourceMessage = (rawText: string) => {
    const messageId = findSourceMessageTarget(slice.agent.messages, rawText);
    if (!messageId) {
      return;
    }
    setDrawerOpen(false);
    setHighlightedMessageId(messageId);
    if (highlightTimer.current) {
      clearTimeout(highlightTimer.current);
    }
    requestAnimationFrame(() => {
      document
        .querySelector(`#${CSS.escape(`slice-message-${messageId}`)}`)
        ?.scrollIntoView({ behavior: "smooth", block: "center" });
    });
    highlightTimer.current = setTimeout(
      () => setHighlightedMessageId(undefined),
      1800
    );
  };
  if (slice.projects === undefined) {
    return <ProjectsLoading />;
  }
  if (!slice.selectedProject) {
    return <ConnectProject slice={slice} />;
  }
  const send = async () => {
    const message = draft.trim();
    if (!message || busy) {
      return;
    }
    await slice.agent.sendMessage(message, {
      images: attachments.images.map((image) => image.file),
    });
    setDraft("");
    attachments.clear();
  };
  return (
    <main
      className="slice-one-surface fixed inset-x-0 top-0 flex min-h-0 overflow-hidden bg-[#f2f0e7] text-[#20201d]"
      style={viewportStyle}
    >
      <section className="flex min-w-0 flex-1 flex-col">
        <header className="relative flex h-14 shrink-0 items-center border-b border-[#d7d3c7] bg-[#faf9f4] px-4">
          <div className="min-w-0 flex-1 pr-2">
            <select
              aria-label="Current project"
              className="block h-7 max-w-full border-0 bg-transparent pr-7 text-sm font-semibold text-[#20201d] outline-none"
              onChange={(event) => slice.selectProject(event.target.value)}
              value={slice.selectedProject.id}
            >
              {slice.projects.map((project) => (
                <option key={project.id} value={project.id}>
                  {project.name}
                </option>
              ))}
            </select>
            <p className="text-[10px] uppercase text-[#858277]">
              Conversation to proposed Work
            </p>
          </div>
          <Button
            aria-label="Project settings"
            className="mr-2 size-9"
            onClick={() => setSettingsOpen((open) => !open)}
            size="icon"
            variant="outline"
          >
            <Settings className="size-4" />
          </Button>
          <button
            className="flex h-9 items-center gap-2 border border-[#c9c5b9] bg-white px-3 text-xs lg:hidden"
            onClick={() => setDrawerOpen(true)}
            type="button"
          >
            <Menu className="size-4" /> Work{" "}
            {slice.works === undefined ? "…" : works.length}
          </button>
          {settingsOpen ? (
            <section className="absolute right-4 top-12 z-40 w-[min(92vw,360px)] border border-[#c9c5b9] bg-[#fffefa] p-4 shadow-xl">
              <div className="flex items-center justify-between">
                <h2 className="text-sm font-semibold">Project Git</h2>
                <button
                  aria-label="Close settings"
                  onClick={() => setSettingsOpen(false)}
                  type="button"
                >
                  <X className="size-4" />
                </button>
              </div>
              <p className="mt-1 text-xs text-[#747168]">
                {slice.projectGitConnection
                  ? `${slice.projectGitConnection.provider} · ${slice.projectGitConnection.serverUrl}`
                  : "No Git credentials attached"}
              </p>
              {slice.operationError ? (
                <p className="mt-2 flex items-start gap-1.5 border border-red-300 bg-red-50 px-2 py-1.5 text-xs text-red-800">
                  <AlertTriangle className="mt-0.5 size-3.5 shrink-0" />
                  <span className="min-w-0 flex-1 leading-5">
                    {slice.operationError.message}
                  </span>
                  <button
                    aria-label="Dismiss error"
                    className="shrink-0"
                    onClick={() => slice.clearOperationError()}
                    type="button"
                  >
                    <X className="size-3.5" />
                  </button>
                </p>
              ) : null}
              <div className="mt-4 flex gap-2">
                <Button
                  size="sm"
                  variant="outline"
                  onClick={() => void slice.authorizeGithub()}
                >
                  Authorize GitHub
                </Button>
                <Button
                  size="sm"
                  onClick={() => void slice.connectLinkedGithub()}
                >
                  Use GitHub
                </Button>
              </div>
              <div className="mt-4 space-y-2 border-t border-[#e7e3d9] pt-4">
                <input
                  aria-label="Gitea server URL"
                  className="h-9 w-full border px-2 text-xs"
                  onChange={(event) => setGiteaUrl(event.target.value)}
                  value={giteaUrl}
                />
                <input
                  aria-label="Gitea username"
                  className="h-9 w-full border px-2 text-xs"
                  onChange={(event) => setGiteaUsername(event.target.value)}
                  placeholder="Username (optional)"
                  value={giteaUsername}
                />
                <input
                  aria-label="Gitea access token"
                  className="h-9 w-full border px-2 text-xs"
                  onChange={(event) => setGiteaToken(event.target.value)}
                  placeholder="Personal access token"
                  type="password"
                  value={giteaToken}
                />
                <Button
                  className="w-full"
                  disabled={!giteaToken.trim()}
                  size="sm"
                  onClick={() => {
                    void slice.connectGitea({
                      serverUrl: giteaUrl,
                      token: giteaToken,
                      username: giteaUsername || undefined,
                    });
                    setGiteaToken("");
                  }}
                >
                  Connect Gitea
                </Button>
              </div>
            </section>
          ) : null}
        </header>
        <Conversation className="min-h-0 flex-1">
          <ConversationContent className="mx-auto min-h-full w-full max-w-2xl gap-4 px-4 py-5 sm:px-6">
            {!slice.agent.historyReady && timeline.length === 0 ? (
              <ConversationLoading />
            ) : null}
            {slice.agent.historyReady && timeline.length === 0 ? (
              <ConversationEmptyState />
            ) : null}
            {timeline.map((item) => {
              if (item.kind === "work") {
                const work = workById.get(item.notice.workId);
                return work ? (
                  <div
                    className="chat-message ml-7"
                    key={`notice-${item.notice.eventId}`}
                  >
                    <p className="mb-2 text-[10px] font-semibold uppercase text-[#65713a]">
                      Work proposed from this conversation
                    </p>
                    <WorkCard
                      onSourceSelect={revealSourceMessage}
                      slice={slice}
                      work={work}
                    />
                  </div>
                ) : null;
              }
              return (
                <div
                  className={`rounded-sm transition-colors duration-300 ${
                    highlightedMessageId === item.message.id
                      ? "bg-[#dcff68]/70 ring-2 ring-[#7f9130] ring-offset-4 ring-offset-[#f2f0e7]"
                      : ""
                  }`}
                  id={`slice-message-${item.message.id}`}
                  key={item.message.id}
                >
                  <ChatMessage message={item.message} />
                </div>
              );
            })}
            {slice.agent.status === "submitted" ? (
              <ChatThinkingResponse />
            ) : null}
          </ConversationContent>
        </Conversation>
        <div className="shrink-0 border-t border-[#d7d3c7] bg-[#faf9f4] p-3 pb-[max(0.75rem,env(safe-area-inset-bottom))]">
          {attachments.images.length > 0 ? (
            <div className="mx-auto max-w-2xl">
              <PendingChatAttachments
                images={attachments.images}
                onRemove={attachments.handleRemove}
              />
            </div>
          ) : null}
          {slice.agent.error ? (
            <p className="mx-auto mb-2 max-w-2xl text-xs text-red-700">
              {slice.agent.error.message}
            </p>
          ) : null}
          {attachments.error ? (
            <p className="mx-auto mb-2 max-w-2xl text-xs text-red-700">
              {attachments.error}
            </p>
          ) : null}
          <div className="mx-auto flex max-w-2xl items-end gap-2">
            <input
              accept="image/*"
              aria-label="Attach images"
              className="sr-only"
              multiple
              onChange={(event) => {
                attachments.addFiles(event.target.files);
                event.target.value = "";
              }}
              ref={imageInput}
              type="file"
            />
            <Button
              aria-label="Attach images"
              className="size-11 shrink-0"
              disabled={busy}
              onClick={() => imageInput.current?.click()}
              size="icon"
              type="button"
              variant="outline"
            >
              <ImagePlus className="size-4" />
            </Button>
            <textarea
              aria-label="Message Zopu"
              className="max-h-32 min-h-11 flex-1 resize-none border border-[#c9c5b9] bg-white px-3 py-2.5 text-sm outline-none focus:border-[#55564e]"
              disabled={busy}
              onChange={(event) => setDraft(event.target.value)}
              onKeyDown={(event) => {
                if (event.key === "Enter" && !event.shiftKey) {
                  event.preventDefault();
                  void send();
                }
              }}
              placeholder="Describe an outcome or problem…"
              rows={1}
              value={draft}
            />
            <Button
              aria-label="Send message"
              className="size-11 shrink-0"
              disabled={!draft.trim() || busy}
              onClick={() => void send()}
              size="icon"
              type="button"
            >
              {busy ? (
                <LoaderCircle className="size-4 animate-spin" />
              ) : (
                <Send className="size-4" />
              )}
            </Button>
          </div>
        </div>
      </section>
      <aside className="hidden w-[380px] shrink-0 overflow-y-auto border-l border-[#d7d3c7] bg-[#e9e7de] p-4 lg:block">
        <h2 className="text-sm font-semibold">Proposed Work</h2>
        <p className="mb-4 text-xs text-[#747168]">
          {works.length} durable outcomes
        </p>
        <div className="space-y-3">
          {works.map((work) => (
            <WorkCard
              key={work._id}
              onSourceSelect={revealSourceMessage}
              slice={slice}
              work={work}
            />
          ))}
        </div>
      </aside>
      {drawerOpen ? (
        <div className="fixed inset-0 z-50 bg-black/30 lg:hidden">
          <button
            aria-label="Close Work drawer"
            className="absolute inset-0"
            onClick={() => setDrawerOpen(false)}
            type="button"
          />
          <section className="absolute inset-y-0 right-0 flex w-[min(92vw,380px)] flex-col bg-[#e9e7de] shadow-2xl">
            <header className="flex h-14 items-center border-b border-[#cfcbc0] px-4">
              <h2 className="flex-1 text-sm font-semibold">Proposed Work</h2>
              <button
                aria-label="Close Work drawer"
                className="grid size-9 place-items-center"
                onClick={() => setDrawerOpen(false)}
                type="button"
              >
                <X className="size-4" />
              </button>
            </header>
            <div className="flex-1 space-y-3 overflow-y-auto p-4">
              {works.length === 0 ? (
                <p className="py-12 text-center text-sm text-[#747168]">
                  Actionable messages will appear here.
                </p>
              ) : null}
              {works.map((work) => (
                <WorkCard
                  key={work._id}
                  onSourceSelect={revealSourceMessage}
                  slice={slice}
                  work={work}
                />
              ))}
            </div>
          </section>
        </div>
      ) : null}
    </main>
  );
 };
--- a/apps/web/src/components/workspace/conversation-composer.tsx
+++ b/apps/web/src/components/workspace/conversation-composer.tsx
@@ -0,0 +1,112 @@
 import { Button } from "@code/ui/components/button";
 import { ImagePlus, LoaderCircle, Send } from "lucide-react";
 import { useRef } from "react";
 import { PendingChatAttachments } from "@/components/chat/chat-attachments";
 import { useChatImages } from "@/hooks/chat/use-chat-images";
 import type { WorkspaceState } from "@/lib/workspace/types";
 export const ConversationComposer = ({
  draft,
  onDraftChange,
  workspace,
 }: {
  readonly draft: string;
  readonly onDraftChange: (draft: string) => void;
  readonly workspace: WorkspaceState;
 }) => {
  const imageInput = useRef<HTMLInputElement>(null);
  const attachments = useChatImages();
  const busy =
    workspace.agent.status === "submitted" ||
    workspace.agent.status === "streaming";
  const send = async () => {
    const message = draft.trim();
    if (!message || busy) {
      return;
    }
    await workspace.agent.sendMessage(message, {
      images: attachments.images.map((image) => image.file),
    });
    onDraftChange("");
    attachments.clear();
  };
  return (
    <div className="shrink-0 border-t border-[#d7d3c7] bg-[#faf9f4] p-3 pb-[max(0.75rem,env(safe-area-inset-bottom))]">
      {attachments.images.length > 0 ? (
        <div className="mx-auto max-w-2xl">
          <PendingChatAttachments
            images={attachments.images}
            onRemove={attachments.handleRemove}
          />
        </div>
      ) : null}
      {workspace.agent.error ? (
        <p className="mx-auto mb-2 max-w-2xl text-xs text-red-700">
          {workspace.agent.error.message}
        </p>
      ) : null}
      {attachments.error ? (
        <p className="mx-auto mb-2 max-w-2xl text-xs text-red-700">
          {attachments.error}
        </p>
      ) : null}
      <div className="mx-auto flex max-w-2xl items-end gap-2">
        <input
          accept="image/*"
          aria-label="Attach images"
          className="sr-only"
          multiple
          onChange={(event) => {
            attachments.addFiles(event.target.files);
            event.target.value = "";
          }}
          ref={imageInput}
          type="file"
        />
        <Button
          aria-label="Attach images"
          className="size-11 shrink-0"
          disabled={busy}
          onClick={() => imageInput.current?.click()}
          size="icon"
          type="button"
          variant="outline"
        >
          <ImagePlus className="size-4" />
        </Button>
        <textarea
          aria-label="Message Zopu"
          className="max-h-32 min-h-11 flex-1 resize-none border border-[#c9c5b9] bg-white px-3 py-2.5 text-sm outline-none focus:border-[#55564e]"
          disabled={busy}
          onChange={(event) => onDraftChange(event.target.value)}
          onKeyDown={(event) => {
            if (event.key === "Enter" && !event.shiftKey) {
              event.preventDefault();
              void send();
            }
          }}
          placeholder="Describe an outcome or problem…"
          rows={1}
          value={draft}
        />
        <Button
          aria-label="Send message"
          className="size-11 shrink-0"
          disabled={!draft.trim() || busy}
          onClick={() => void send()}
          size="icon"
          type="button"
        >
          {busy ? (
            <LoaderCircle className="size-4 animate-spin" />
          ) : (
            <Send className="size-4" />
          )}
        </Button>
      </div>
    </div>
  );
 };
--- a/apps/web/src/components/workspace/conversation-feed.tsx
+++ b/apps/web/src/components/workspace/conversation-feed.tsx
@@ -0,0 +1,108 @@
 import { projectWorkNotices } from "@code/primitives/work";
 import {
  Conversation,
  ConversationContent,
 } from "@code/ui/components/ai-elements/conversation";
 import { MessageSquareText } from "lucide-react";
 import { useMemo } from "react";
 import { ChatMessage } from "@/components/chat/chat-message";
 import { ChatThinkingResponse } from "@/components/chat/chat-thinking-response";
 import { buildWorkspaceTimeline } from "@/lib/workspace/presentation";
 import type { WorkRecord, WorkspaceState } from "@/lib/workspace/types";
 import { WorkCard } from "./work-card";
 const ConversationLoading = () => (
  <output
    aria-label="Loading conversation"
    className="mx-auto flex min-h-[55vh] w-full max-w-md flex-col justify-center gap-4"
  >
    <span className="h-16 w-4/5 animate-pulse rounded-sm bg-[#e3e0d5]" />
    <span className="ml-auto h-12 w-3/5 animate-pulse rounded-sm bg-[#dedbd0]" />
    <span className="h-24 w-full animate-pulse rounded-sm bg-[#e3e0d5]" />
    <span className="sr-only">Loading conversation…</span>
  </output>
 );
 const ConversationEmptyState = () => (
  <div className="grid min-h-[55vh] place-items-center text-center">
    <div>
      <MessageSquareText className="mx-auto size-7 text-[#8a887f]" />
      <h1 className="mt-4 text-xl font-semibold">What should move forward?</h1>
      <p className="mx-auto mt-2 max-w-sm text-sm leading-6 text-[#69675f]">
        Describe an outcome or problem. Casual conversation stays conversation.
      </p>
    </div>
  </div>
 );
 export const ConversationFeed = ({
  highlightedMessageId,
  onSourceSelect,
  workspace,
 }: {
  readonly highlightedMessageId?: string;
  readonly onSourceSelect: (rawText: string) => void;
  readonly workspace: WorkspaceState;
 }) => {
  const works = workspace.works ?? [];
  const workById = new Map(
    works.map((work) => [String(work._id), work] as const)
  );
  const notices = projectWorkNotices(works);
  const timeline = useMemo(
    () => buildWorkspaceTimeline(workspace.agent.messages, notices),
    [notices, workspace.agent.messages]
  );
  return (
    <Conversation className="min-h-0 flex-1">
      <ConversationContent className="mx-auto min-h-full w-full max-w-2xl gap-4 px-4 py-5 sm:px-6">
        {!workspace.agent.historyReady && timeline.length === 0 ? (
          <ConversationLoading />
        ) : null}
        {workspace.agent.historyReady && timeline.length === 0 ? (
          <ConversationEmptyState />
        ) : null}
        {timeline.map((item) => {
          if (item.kind === "work") {
            const work = workById.get(item.notice.workId) as
              | WorkRecord
              | undefined;
            return work ? (
              <div
                className="chat-message ml-7"
                key={`notice-${item.notice.eventId}`}
              >
                <p className="mb-2 text-[10px] font-semibold uppercase text-[#65713a]">
                  Work proposed from this conversation
                </p>
                <div className="rounded-sm">
                  <span className="sr-only">Proposed Work</span>
                  <WorkCard
                    onSourceSelect={onSourceSelect}
                    work={work}
                    workspace={workspace}
                  />
                </div>
              </div>
            ) : null;
          }
          return (
            <div
              className={`rounded-sm transition-colors duration-300 ${highlightedMessageId === item.message.id ? "bg-[#dcff68]/70 ring-2 ring-[#7f9130] ring-offset-4 ring-offset-[#f2f0e7]" : ""}`}
              id={`workspace-message-${item.message.id}`}
              key={item.message.id}
            >
              <ChatMessage message={item.message} />
            </div>
          );
        })}
        {workspace.agent.status === "submitted" ? (
          <ChatThinkingResponse />
        ) : null}
      </ConversationContent>
    </Conversation>
  );
 };
--- a/apps/web/src/components/workspace/project-connect-form.tsx
+++ b/apps/web/src/components/workspace/project-connect-form.tsx
@@ -0,0 +1,50 @@
 import { Button } from "@code/ui/components/button";
 import { FolderGit2, LoaderCircle } from "lucide-react";
 import type { WorkspaceState } from "@/lib/workspace/types";
 export const ProjectConnectForm = ({
  workspace,
 }: {
  readonly workspace: WorkspaceState;
 }) => (
  <main className="grid min-h-svh place-items-center bg-[#f2f0e7] px-5 text-[#20201d]">
    <form
      className="w-full max-w-sm"
      onSubmit={(event) => {
        event.preventDefault();
        void workspace.connectRepository();
      }}
    >
      <span className="grid size-11 place-items-center bg-[#20201d] text-white">
        <FolderGit2 className="size-5" />
      </span>
      <h1 className="mt-6 text-2xl font-semibold">Connect a project</h1>
      <p className="mt-2 text-sm leading-6 text-[#68665e]">
        Turn actionable project conversation into proposed Work with exact
        provenance.
      </p>
      <input
        aria-label="Public Git repository URL"
        className="mt-6 h-12 w-full border border-[#c9c5b9] bg-[#fffefa] px-3 text-sm outline-none focus:border-[#55564e]"
        onChange={(event) => workspace.setRepository(event.target.value)}
        placeholder="https://github.com/owner/repository"
        required
        value={workspace.repository}
      />
      {workspace.error ? (
        <p className="mt-2 text-xs text-red-700">{workspace.error.message}</p>
      ) : null}
      <Button
        className="mt-3 h-12 w-full"
        disabled={workspace.pending}
        type="submit"
      >
        {workspace.pending ? (
          <LoaderCircle className="size-4 animate-spin" />
        ) : null}
        {workspace.pending ? "Connecting" : "Connect project"}
      </Button>
    </form>
  </main>
 );
--- a/apps/web/src/components/workspace/project-header.tsx
+++ b/apps/web/src/components/workspace/project-header.tsx
@@ -0,0 +1,63 @@
 import { Button } from "@code/ui/components/button";
 import { Menu, Settings } from "lucide-react";
 import { useState } from "react";
 import type { WorkspaceState } from "@/lib/workspace/types";
 import { ProjectSettingsPanel } from "./project-settings-panel";
 export const ProjectHeader = ({
  onOpenDrawer,
  workspace,
 }: {
  readonly onOpenDrawer: () => void;
  readonly workspace: WorkspaceState;
 }) => {
  const [settingsOpen, setSettingsOpen] = useState(false);
  const works = workspace.works ?? [];
  return (
    <header className="relative flex h-14 shrink-0 items-center border-b border-[#d7d3c7] bg-[#faf9f4] px-4">
      <div className="min-w-0 flex-1 pr-2">
        <select
          aria-label="Current project"
          className="block h-7 max-w-full border-0 bg-transparent pr-7 text-sm font-semibold text-[#20201d] outline-none"
          onChange={(event) => workspace.selectProject(event.target.value)}
          value={workspace.selectedProject?.id ?? ""}
        >
          {(workspace.projects ?? []).map((project) => (
            <option key={project.id} value={project.id}>
              {project.name}
            </option>
          ))}
        </select>
        <p className="text-[10px] uppercase text-[#858277]">
          Conversation to proposed Work
        </p>
      </div>
      <Button
        aria-label="Project settings"
        className="mr-2 size-9"
        onClick={() => setSettingsOpen((open) => !open)}
        size="icon"
        variant="outline"
      >
        <Settings className="size-4" />
      </Button>
      <button
        className="flex h-9 items-center gap-2 border border-[#c9c5b9] bg-white px-3 text-xs lg:hidden"
        onClick={onOpenDrawer}
        type="button"
      >
        <Menu className="size-4" /> Work{" "}
        {workspace.works === undefined ? "…" : works.length}
      </button>
      {settingsOpen ? (
        <ProjectSettingsPanel
          onClose={() => setSettingsOpen(false)}
          workspace={workspace}
        />
      ) : null}
    </header>
  );
 };
--- a/apps/web/src/components/workspace/project-settings-panel.tsx
+++ b/apps/web/src/components/workspace/project-settings-panel.tsx
@@ -0,0 +1,100 @@
 import { Button } from "@code/ui/components/button";
 import { AlertTriangle, X } from "lucide-react";
 import { useState } from "react";
 import type { WorkspaceState } from "@/lib/workspace/types";
 export const ProjectSettingsPanel = ({
  onClose,
  workspace,
 }: {
  readonly onClose: () => void;
  readonly workspace: WorkspaceState;
 }) => {
  const [serverUrl, setServerUrl] = useState("https://git.openputer.com");
  const [username, setUsername] = useState("");
  const [token, setToken] = useState("");
  const handleClearOperationError = () => workspace.clearOperationError();
  return (
    <section className="absolute right-4 top-12 z-40 w-[min(92vw,360px)] border border-[#c9c5b9] bg-[#fffefa] p-4 shadow-xl">
      <div className="flex items-center justify-between">
        <h2 className="text-sm font-semibold">Project Git</h2>
        <button aria-label="Close settings" onClick={onClose} type="button">
          <X className="size-4" />
        </button>
      </div>
      <p className="mt-1 text-xs text-[#747168]">
        {workspace.projectGitConnection
          ? `${workspace.projectGitConnection.provider} · ${workspace.projectGitConnection.serverUrl}`
          : "No Git credentials attached"}
      </p>
      {workspace.operationError ? (
        <p className="mt-2 flex items-start gap-1.5 border border-red-300 bg-red-50 px-2 py-1.5 text-xs text-red-800">
          <AlertTriangle className="mt-0.5 size-3.5 shrink-0" />
          <span className="min-w-0 flex-1 leading-5">
            {workspace.operationError.message}
          </span>
          <button
            aria-label="Dismiss error"
            className="shrink-0"
            onClick={handleClearOperationError}
            type="button"
          >
            <X className="size-3.5" />
          </button>
        </p>
      ) : null}
      <div className="mt-4 flex gap-2">
        <Button
          size="sm"
          variant="outline"
          onClick={() => void workspace.authorizeGithub()}
        >
          Authorize GitHub
        </Button>
        <Button size="sm" onClick={() => void workspace.connectLinkedGithub()}>
          Use GitHub
        </Button>
      </div>
      <div className="mt-4 space-y-2 border-t border-[#e7e3d9] pt-4">
        <input
          aria-label="Gitea server URL"
          className="h-9 w-full border px-2 text-xs"
          onChange={(event) => setServerUrl(event.target.value)}
          value={serverUrl}
        />
        <input
          aria-label="Gitea username"
          className="h-9 w-full border px-2 text-xs"
          onChange={(event) => setUsername(event.target.value)}
          placeholder="Username (optional)"
          value={username}
        />
        <input
          aria-label="Gitea access token"
          className="h-9 w-full border px-2 text-xs"
          onChange={(event) => setToken(event.target.value)}
          placeholder="Personal access token"
          type="password"
          value={token}
        />
        <Button
          className="w-full"
          disabled={!token.trim()}
          size="sm"
          onClick={() => {
            void workspace.connectGitea({
              serverUrl,
              token,
              username: username || undefined,
            });
            setToken("");
          }}
        >
          Connect Gitea
        </Button>
      </div>
    </section>
  );
 };
--- a/apps/web/src/components/workspace/project-workspace-page.tsx
+++ b/apps/web/src/components/workspace/project-workspace-page.tsx
@@ -0,0 +1,123 @@
 import { useRef, useState } from "react";
 import { useProjectWorkspace } from "@/hooks/workspace/use-project-workspace";
 import { useVisualViewportStyle } from "@/hooks/workspace/use-visual-viewport";
 import { findSourceMessageTarget } from "@/lib/workspace/presentation";
 import { ConversationComposer } from "./conversation-composer";
 import { ConversationFeed } from "./conversation-feed";
 import { ProjectConnectForm } from "./project-connect-form";
 import { ProjectHeader } from "./project-header";
 import { WorkFeed } from "./work-feed";
 const ProjectLoading = () => (
  <main className="grid min-h-svh place-items-center bg-[#f2f0e7]">
    <span className="size-5 animate-spin rounded-full border-2 border-[#20201d] border-t-transparent" />
  </main>
 );
 export const ProjectWorkspacePage = () => {
  const workspace = useProjectWorkspace();
  const viewportStyle = useVisualViewportStyle();
  const [draft, setDraft] = useState("");
  const [drawerOpen, setDrawerOpen] = useState(false);
  const [highlightedMessageId, setHighlightedMessageId] = useState<string>();
  const highlightTimer = useRef<ReturnType<typeof setTimeout> | null>(null);
  if (workspace.projects === undefined) {
    return <ProjectLoading />;
  }
  if (!workspace.selectedProject) {
    return <ProjectConnectForm workspace={workspace} />;
  }
  const works = workspace.works ?? [];
  const revealSourceMessage = (rawText: string) => {
    const messageId = findSourceMessageTarget(
      workspace.agent.messages,
      rawText
    );
    if (!messageId) {
      return;
    }
    setDrawerOpen(false);
    setHighlightedMessageId(messageId);
    if (highlightTimer.current) {
      clearTimeout(highlightTimer.current);
    }
    requestAnimationFrame(() =>
      document
        .querySelector(`#workspace-message-${CSS.escape(messageId)}`)
        ?.scrollIntoView({ behavior: "smooth", block: "center" })
    );
    highlightTimer.current = setTimeout(
      () => setHighlightedMessageId(undefined),
      1800
    );
  };
  return (
    <main
      className="workspace-surface fixed inset-x-0 top-0 flex min-h-0 overflow-hidden bg-[#f2f0e7] text-[#20201d]"
      style={viewportStyle}
    >
      <section className="flex min-w-0 flex-1 flex-col">
        <ProjectHeader
          onOpenDrawer={() => setDrawerOpen(true)}
          workspace={workspace}
        />
        <ConversationFeed
          highlightedMessageId={highlightedMessageId}
          onSourceSelect={revealSourceMessage}
          workspace={workspace}
        />
        <ConversationComposer
          draft={draft}
          onDraftChange={setDraft}
          workspace={workspace}
        />
      </section>
      <aside className="hidden w-[380px] shrink-0 overflow-y-auto border-l border-[#d7d3c7] bg-[#e9e7de] p-4 lg:block">
        <h2 className="text-sm font-semibold">Proposed Work</h2>
        <p className="mb-4 text-xs text-[#747168]">
          {works.length} durable outcomes
        </p>
        <WorkFeed
          onSourceSelect={revealSourceMessage}
          works={works}
          workspace={workspace}
        />
      </aside>
      {drawerOpen ? (
        <div className="fixed inset-0 z-50 bg-black/30 lg:hidden">
          <button
            aria-label="Close Work drawer"
            className="absolute inset-0"
            onClick={() => setDrawerOpen(false)}
            type="button"
          />
          <section className="absolute inset-y-0 right-0 flex w-[min(92vw,380px)] flex-col bg-[#e9e7de] shadow-2xl">
            <header className="flex h-14 items-center border-b border-[#cfcbc0] px-4">
              <h2 className="flex-1 text-sm font-semibold">Proposed Work</h2>
              <button
                aria-label="Close Work drawer"
                className="grid size-9 place-items-center"
                onClick={() => setDrawerOpen(false)}
                type="button"
              >
                ×
              </button>
            </header>
            <div className="flex-1 overflow-y-auto p-4">
              <WorkFeed
                onSourceSelect={revealSourceMessage}
                works={works}
                workspace={workspace}
              />
            </div>
          </section>
        </div>
      ) : null}
    </main>
  );
 };
--- a/apps/web/src/components/workspace/work-card.tsx
+++ b/apps/web/src/components/workspace/work-card.tsx
@@ -0,0 +1,395 @@
 import { Button } from "@code/ui/components/button";
 import {
  AlertTriangle,
  Check,
  ChevronRight,
  FileCode2,
  Hammer,
  Play,
  RotateCcw,
  ScrollText,
  Sparkles,
  X,
 } from "lucide-react";
 import { useState } from "react";
 import { changedFilesFor } from "@/lib/workspace/types";
 import type { WorkRecord, WorkspaceState } from "@/lib/workspace/types";
 interface WorkCardProps {
  readonly onSourceSelect: (rawText: string) => void;
  readonly work: WorkRecord;
  readonly workspace: WorkspaceState;
 }
 const starterDefinition = (work: WorkRecord) => ({
  acceptanceCriteria: ["The requested outcome is observable and documented"],
  affectedUsers: ["Project users"],
  assumptions: [],
  constraints: [],
  desiredOutcome: work.objective,
  inScope: [work.objective],
  outOfScope: ["Unrelated product changes"],
  problem: work.objective,
  questions: [],
  requiredArtifacts: ["Simulation activity and terminal outcome"],
  risk: "medium",
 });
 const starterDesign = (work: WorkRecord) => ({
  architectureSummary:
    "Validate the approved Definition, then exercise one deterministic fake slice.",
  callFlowDelta: [
    "Work -> Run -> Attempt -> normalized events -> terminal outcome",
  ],
  concerns: [],
  evidenceRequirements: ["Terminal Run classification"],
  fileTreeDelta: [],
  impactMap: {
    files: [],
    modules: [],
    risks: [],
    summary: "Compact vertical-slice simulation",
  },
  invariants: [
    "Simulation never claims implementation",
    "Every Attempt reaches a terminal classification",
  ],
  keyInterfaces: ["HarnessRuntime", "AttemptOutcome"],
  slices: [
    {
      codeBoundaries: ["workExecution"],
      dependsOn: [],
      evidenceRequirements: ["Normalized activity events"],
      id: "deterministic-simulation",
      objective: work.objective,
      observableBehavior: "A terminal fake Run is visible",
      reviewRequired: false,
      title: "Deterministic simulation",
      verification: ["Run completes with a terminal classification"],
    },
  ],
  tradeoffs: ["Fake runtime proves contract before sandbox integration"],
 });
 // oxlint-disable-next-line complexity -- this card intentionally coordinates review actions and run evidence.
 export const WorkCard = ({
  onSourceSelect,
  work,
  workspace,
 }: WorkCardProps) => {
  const [sourcesOpen, setSourcesOpen] = useState(false);
  const [expanded, setExpanded] = useState(false);
  const [logsOpen, setLogsOpen] = useState(false);
  const sources = work.signals.flatMap((signal) => signal.sources);
  const [latestRun] = work.runs;
  const openQuestions =
    work.definition?.questions?.filter((question) => question.status === "open")
      .length ?? 0;
  return (
    <article className="border border-[#d7d3c7] bg-[#fffefa] p-4 text-[#20201d] shadow-[0_10px_30px_rgba(30,30,20,0.06)]">
      <div className="flex items-start gap-3">
        <span className="grid size-8 shrink-0 place-items-center bg-[#dcff68]">
          <Sparkles className="size-4" />
        </span>
        <div className="min-w-0 flex-1">
          <p className="text-[10px] font-semibold uppercase text-[#65713a]">
            Proposed Work
          </p>
          <h2 className="mt-1 text-[15px] font-semibold leading-5">
            {work.title}
          </h2>
          <p className="mt-1.5 text-[13px] leading-5 text-[#626057]">
            {work.objective}
          </p>
        </div>
      </div>
      <button
        className="mt-3 flex w-full items-center justify-between border-t border-[#e7e3d9] pt-3 text-left text-xs text-[#69675e]"
        onClick={() => setSourcesOpen((open) => !open)}
        type="button"
      >
        <span>
          {sources.length} exact source{" "}
          {sources.length === 1 ? "message" : "messages"}
        </span>
        <ChevronRight
          className={`size-4 transition-transform ${sourcesOpen ? "rotate-90" : ""}`}
        />
      </button>
      <button
        className="mt-2 flex w-full items-center justify-between border-t border-[#e7e3d9] pt-3 text-left text-xs font-medium text-[#20201d]"
        onClick={() => setExpanded((open) => !open)}
        type="button"
      >
        <span>{expanded ? "Hide Work details" : "Open Work details"}</span>
        <ChevronRight
          className={`size-4 transition-transform ${expanded ? "rotate-90" : ""}`}
        />
      </button>
      {sourcesOpen ? (
        <div className="mt-3 space-y-2">
          {sources.map((source) => (
            <button
              className="flex w-full items-start gap-2 border-l-2 border-[#a8b750] bg-[#f4f2e9] px-3 py-2 text-left text-xs leading-5 hover:bg-[#ece9dd]"
              key={source.messageId}
              onClick={() => onSourceSelect(source.rawText)}
              type="button"
            >
              <span className="min-w-0 flex-1">{source.rawText}</span>
            </button>
          ))}
        </div>
      ) : null}
      {expanded ? (
        <div className="mt-4 space-y-4 border-t border-[#e7e3d9] pt-4 text-xs">
          <section>
            <p className="font-semibold uppercase tracking-wide text-[#65713a]">
              Outcome
            </p>
            <p className="mt-1 leading-5 text-[#626057]">{work.objective}</p>
            <p className="mt-2 text-[#747168]">
              Risk: {work.definition?.risk ?? "not defined"}
            </p>
            {openQuestions > 0 ? (
              <p className="mt-1 text-amber-800">
                {openQuestions} open question(s)
              </p>
            ) : null}
            <div className="mt-2 flex flex-wrap gap-2">
              {work.status === "proposed" ? (
                <Button
                  size="sm"
                  onClick={() => void workspace.requestDefinition(work._id)}
                >
                  <Sparkles className="size-3.5" /> Define
                </Button>
              ) : null}
              {work.status === "defining" ? (
                <Button
                  size="sm"
                  variant="outline"
                  onClick={() =>
                    void workspace.saveDefinition(
                      work._id,
                      starterDefinition(work)
                    )
                  }
                >
                  <Hammer className="size-3.5" /> Save definition
                </Button>
              ) : null}
              {work.status === "awaiting-definition-approval" &&
              work.definitionVersion ? (
                <Button
                  size="sm"
                  onClick={() =>
                    void workspace.approveDefinition(
                      work._id,
                      work.definitionVersion as number
                    )
                  }
                >
                  <Check className="size-3.5" /> Approve
                </Button>
              ) : null}
            </div>
          </section>
          <section>
            <p className="font-semibold uppercase tracking-wide text-[#65713a]">
              Design
            </p>
            <p className="mt-1 leading-5 text-[#626057]">
              {work.design?.architectureSummary ?? "No Design Packet yet."}
            </p>
            {work.design?.slices?.map((item) => (
              <p className="mt-1 text-[#747168]" key={item.id}>
                {item.title}: {item.observableBehavior}
              </p>
            ))}
            <div className="mt-2 flex flex-wrap gap-2">
              {work.status === "designing" ? (
                <Button
                  size="sm"
                  variant="outline"
                  onClick={() =>
                    void workspace.saveDesign(work._id, starterDesign(work))
                  }
                >
                  <Hammer className="size-3.5" /> Save design
                </Button>
              ) : null}
              {work.status === "awaiting-design-approval" &&
              work.definitionApprovalVersion &&
              work.designVersion ? (
                <Button
                  size="sm"
                  onClick={() =>
                    void workspace.approveDesign(
                      work._id,
                      work.definitionApprovalVersion as number,
                      work.designVersion as number
                    )
                  }
                >
                  <Check className="size-3.5" /> Approve design
                </Button>
              ) : null}
            </div>
          </section>
          <section>
            <p className="font-semibold uppercase tracking-wide text-[#65713a]">
              Build
            </p>
            {workspace.operationError ? (
              <p className="mt-2 flex items-start gap-1.5 border border-red-300 bg-red-50 px-2 py-1.5 text-red-800">
                <AlertTriangle className="mt-0.5 size-3.5 shrink-0" />
                <span className="min-w-0 flex-1 leading-5">
                  {workspace.operationError.message}
                </span>
                <button
                  aria-label="Dismiss error"
                  className="shrink-0"
                  onClick={() => workspace.clearOperationError()}
                  type="button"
                >
                  <X className="size-3.5" />
                </button>
              </p>
            ) : null}
            {latestRun ? (
              <div className="mt-1 space-y-2 text-[#626057]">
                <p className="leading-5">
                  {latestRun.executionKind === "real"
                    ? "AgentOS"
                    : "Simulation"}{" "}
                  run {latestRun.status}:{" "}
                  {latestRun.terminalSummary ??
                    latestRun.terminalClassification ??
                    "activity is still arriving"}
                </p>
                {latestRun.baseRevision ? (
                  <p className="font-mono text-[10px] text-[#747168]">
                    {latestRun.baseRevision.slice(0, 8)} →{" "}
                    {latestRun.candidateRevision?.slice(0, 8) ?? "working"}
                  </p>
                ) : null}
                {latestRun.artifacts?.map((artifact) => (
                  <div key={artifact._id} className="space-y-1">
                    <p className="font-medium">
                      {artifact.uri ? (
                        <a
                          className="underline"
                          href={artifact.uri}
                          rel="noreferrer"
                          target="_blank"
                        >
                          {artifact.title}
                        </a>
                      ) : (
                        artifact.title
                      )}
                    </p>
                    {changedFilesFor(artifact).length > 0 ? (
                      <ul className="space-y-0.5">
                        {changedFilesFor(artifact).map((file) => (
                          <li
                            className="flex items-start gap-1.5 font-mono text-[11px] leading-5 text-[#747168]"
                            key={file}
                          >
                            <FileCode2 className="mt-0.5 size-3 shrink-0 text-[#9a985f]" />
                            <span className="min-w-0 break-all">{file}</span>
                          </li>
                        ))}
                      </ul>
                    ) : null}
                  </div>
                ))}
                {latestRun.attemptEvents &&
                latestRun.attemptEvents.length > 0 ? (
                  <div className="space-y-1">
                    {(logsOpen
                      ? latestRun.attemptEvents
                      : latestRun.attemptEvents.slice(-3)
                    ).map((item) => (
                      <p
                        className="border-l-2 border-[#b8c760] pl-2 leading-5"
                        key={item._id}
                      >
                        {item.message}
                      </p>
                    ))}
                    {latestRun.attemptEvents.length > 3 ? (
                      <button
                        className="flex items-center gap-1 font-medium text-[#65713a] hover:underline"
                        onClick={() => setLogsOpen((open) => !open)}
                        type="button"
                      >
                        <ScrollText className="size-3.5" />
                        {logsOpen
                          ? "Show recent activity"
                          : `Show full activity log (${latestRun.attemptEvents.length})`}
                        <ChevronRight
                          className={`size-3.5 transition-transform ${logsOpen ? "rotate-90" : ""}`}
                        />
                      </button>
                    ) : null}
                  </div>
                ) : null}
              </div>
            ) : (
              <p className="mt-1 text-[#747168]">No implementation Run yet.</p>
            )}
            <div className="mt-2 flex flex-wrap gap-2">
              {work.status === "ready" ? (
                <>
                  <Button
                    size="sm"
                    disabled={!workspace.projectGitConnection}
                    onClick={() => void workspace.startExecution(work._id)}
                  >
                    <Play className="size-3.5" /> Run
                  </Button>
                  <Button
                    size="sm"
                    variant="outline"
                    onClick={() =>
                      void workspace.startSimulation(work._id, "success")
                    }
                  >
                    <Play className="size-3.5" /> Simulate
                  </Button>
                </>
              ) : null}
              {latestRun?.status === "running" ? (
                <Button
                  size="sm"
                  variant="outline"
                  onClick={() =>
                    void (latestRun.executionKind === "real"
                      ? workspace.cancelExecution(latestRun._id)
                      : workspace.cancelSimulation(latestRun._id))
                  }
                >
                  <X className="size-3.5" /> Cancel
                </Button>
              ) : null}
              {latestRun?.executionKind !== "real" &&
              latestRun?.status === "terminal" &&
              latestRun.terminalClassification === "RetryableFailure" ? (
                <Button
                  size="sm"
                  variant="outline"
                  onClick={() => void workspace.retrySimulation(latestRun._id)}
                >
                  <RotateCcw className="size-3.5" /> Retry
                </Button>
              ) : null}
            </div>
          </section>
        </div>
      ) : null}
    </article>
  );
 };
--- a/apps/web/src/components/workspace/work-feed.tsx
+++ b/apps/web/src/components/workspace/work-feed.tsx
@@ -0,0 +1,29 @@
 import type { WorkRecord, WorkspaceState } from "@/lib/workspace/types";
 import { WorkCard } from "./work-card";
 export const WorkFeed = ({
  onSourceSelect,
  works,
  workspace,
 }: {
  readonly onSourceSelect: (rawText: string) => void;
  readonly works: readonly WorkRecord[];
  readonly workspace: WorkspaceState;
 }) => (
  <div className="space-y-3">
    {works.length === 0 ? (
      <p className="py-12 text-center text-sm text-[#747168]">
        Actionable messages will appear here.
      </p>
    ) : null}
    {works.map((work) => (
      <WorkCard
        key={work._id}
        onSourceSelect={onSourceSelect}
        work={work}
        workspace={workspace}
      />
    ))}
  </div>
 );
--- a/apps/web/src/hooks/workspace/use-project-workspace.ts
+++ b/apps/web/src/hooks/workspace/use-project-workspace.ts
@@ -7,60 +7,17 @@ import { useMemo, useState } from "react";
 import { useOrganizationChatAgent } from "@/hooks/chat/use-chat-agent";
 import { usePersonalOrganization } from "@/hooks/use-personal-organization";
 import type { WorkRecord, WorkspaceState } from "@/lib/workspace/types";
 const toError = (error: unknown) =>
  error instanceof Error ? error : new Error(String(error));
-interface WorkRecord {
+type ExecutionScenario =
-  readonly _id: Id<"works">;
+  | "success"
-  readonly title: string;
+  | "transient-failure-then-success"
-  readonly objective: string;
+  | "needs-input"
-  readonly status: string;
+  | "permanent-failure"
-  readonly definitionVersion?: number;
+  | "cancelled";
  readonly definitionApprovalVersion?: number;
  readonly designVersion?: number;
  readonly designApprovalVersion?: number;
  readonly signals: readonly {
    sources: readonly { messageId: string; rawText: string }[];
  }[];
  readonly events: readonly { _id: string; createdAt: number; kind: string }[];
  readonly definitions: readonly unknown[];
  readonly designs: readonly unknown[];
  readonly slices: readonly unknown[];
  readonly runs: readonly {
    readonly artifacts?: readonly {
      _id: string;
      kind: string;
      metadataJson: string;
      sourceRevision?: string;
      title: string;
      uri?: string;
    }[];
    readonly attemptEvents?: readonly {
      _id: string;
      kind: string;
      message: string;
      metadataJson: string;
      occurredAt: number;
      sequence: number;
    }[];
    readonly baseRevision?: string;
    readonly candidateRevision?: string;
    readonly executionKind?: string;
    _id: Id<"workRuns">;
    status: string;
    terminalClassification?: string;
    terminalSummary?: string;
  }[];
  readonly definition: {
    risk?: string;
    questions?: { status: string }[];
  } | null;
  readonly design: {
    architectureSummary?: string;
    slices?: { id: string; title: string; observableBehavior: string }[];
  } | null;
 }
 const workListRef = makeFunctionReference<
  "query",
@@ -94,16 +51,7 @@ const approveDesignRef = makeFunctionReference<
 >("workPlanning:approveDesign");
 const startSimulationRef = makeFunctionReference<
  "mutation",
-  {
+  { workId: Id<"works">; scenario: ExecutionScenario; sliceId?: string },
    workId: Id<"works">;
    scenario:
      | "success"
      | "transient-failure-then-success"
      | "needs-input"
      | "permanent-failure"
      | "cancelled";
    sliceId?: string;
  },
  unknown
 >("workExecution:startSimulatedExecution");
 const cancelSimulationRef = makeFunctionReference<
@@ -162,13 +110,7 @@ const attachGitConnectionRef = makeFunctionReference<
  unknown
 >("gitConnectionData:attachToProject");
-const authorizeGithub = () =>
+export const useProjectWorkspace = (): WorkspaceState => {
  authClient.signIn.social({
    callbackURL: window.location.href,
    provider: "github",
  });
 export const useSliceOne = () => {
  const organization = usePersonalOrganization();
  const projects = useQuery(
    api.projects.list,
@@ -182,19 +124,7 @@ export const useSliceOne = () => {
  const [pending, setPending] = useState(false);
  const [error, setError] = useState<Error>();
  const [operationError, setOperationError] = useState<Error>();
-  const captureOperationError =
+
    <TArgs extends unknown[], TResult>(
      operation: (...args: TArgs) => Promise<TResult>
    ) =>
    async (...args: TArgs): Promise<TResult> => {
      setOperationError(undefined);
      try {
        return await operation(...args);
      } catch (caughtError) {
        setOperationError(toError(caughtError));
        throw caughtError;
      }
    };
  const selectedProjectStillExists = projects?.some(
    (project) => project.id === (selectedProjectId as unknown as string)
  );
@@ -234,6 +164,16 @@ export const useSliceOne = () => {
    [activeProjectId, projects]
  );
  const runOperation = async <T>(operation: () => Promise<T>): Promise<T> => {
    setOperationError(undefined);
    try {
      return await operation();
    } catch (caughtError) {
      setOperationError(toError(caughtError));
      throw caughtError;
    }
  };
  const connectRepository = async () => {
    const repositoryUrl = repository.trim();
    if (!repositoryUrl || pending) {
@@ -252,44 +192,6 @@ export const useSliceOne = () => {
    }
  };
  const selectProject = (projectId: string) => {
    setSelectedProjectId(projectId as unknown as Id<"projects">);
  };
  const requestDefinition = (workId: Id<"works">) =>
    requestDefinitionMutation({ workId });
  const saveDefinition = (workId: Id<"works">, payload: unknown) =>
    saveDefinitionMutation({ payloadJson: JSON.stringify(payload), workId });
  const approveDefinition = (workId: Id<"works">, version: number) =>
    approveDefinitionMutation({ version, workId });
  const saveDesign = (workId: Id<"works">, payload: unknown) =>
    saveDesignMutation({ payloadJson: JSON.stringify(payload), workId });
  const approveDesign = (
    workId: Id<"works">,
    definitionVersion: number,
    designVersion: number
  ) => approveDesignMutation({ definitionVersion, designVersion, workId });
  const startSimulation = (
    workId: Id<"works">,
    scenario:
      | "success"
      | "transient-failure-then-success"
      | "needs-input"
      | "permanent-failure"
      | "cancelled",
    sliceId?: string
  ) =>
    captureOperationError(() =>
      startSimulationMutation({ scenario, sliceId, workId })
    )();
  const cancelSimulation = (runId: Id<"workRuns">) =>
    captureOperationError(() => cancelSimulationMutation({ runId }))();
  const retrySimulation = (runId: Id<"workRuns">) =>
    captureOperationError(() => retrySimulationMutation({ runId }))();
  const startExecution = (workId: Id<"works">, sliceId?: string) =>
    captureOperationError(() => startExecutionMutation({ sliceId, workId }))();
  const cancelExecution = (runId: Id<"workRuns">) =>
    captureOperationError(() => cancelExecutionMutation({ runId }))();
  const attachConnection = async (connectionId: Id<"gitConnections">) => {
    if (!activeProjectId) {
      throw new Error("Select a project first");
@@ -299,24 +201,41 @@ export const useSliceOne = () => {
      projectId: activeProjectId,
    });
  };
-  const connectGitea = captureOperationError(
+
-    async (input: { serverUrl: string; token: string; username?: string }) => {
+  const connectGitea = (input: {
    serverUrl: string;
    token: string;
    username?: string;
  }) =>
    runOperation(async () => {
      const result = await connectGiteaAction(input);
      await attachConnection(result.connectionId);
-    }
+    });
-  );
+
-  const connectLinkedGithub = captureOperationError(async () => {
+  const connectLinkedGithub = () =>
-    const result = await connectGithubAction({});
+    runOperation(async () => {
-    await attachConnection(result.connectionId);
+      const result = await connectGithubAction({});
-  });
+      await attachConnection(result.connectionId);
    });
  return {
    agent,
-    approveDefinition,
+    approveDefinition: (workId: Id<"works">, version: number) =>
-    approveDesign,
+      approveDefinitionMutation({ version, workId }),
-    authorizeGithub,
+    approveDesign: (
-    cancelExecution,
+      workId: Id<"works">,
-    cancelSimulation,
+      definitionVersion: number,
      designVersion: number
    ) => approveDesignMutation({ definitionVersion, designVersion, workId }),
    authorizeGithub: () =>
      authClient.signIn.social({
        callbackURL: window.location.href,
        provider: "github",
      }),
    cancelExecution: (runId: Id<"workRuns">) =>
      runOperation(() => cancelExecutionMutation({ runId })),
    cancelSimulation: (runId: Id<"workRuns">) =>
      runOperation(() => cancelSimulationMutation({ runId })),
    clearOperationError: () => setOperationError(undefined),
    connectGitea,
    connectLinkedGithub,
@@ -328,15 +247,30 @@ export const useSliceOne = () => {
    projectGitConnection,
    projects,
    repository,
-    requestDefinition,
+    requestDefinition: (workId: Id<"works">) =>
-    retrySimulation,
+      requestDefinitionMutation({ workId }),
-    saveDefinition,
+    retrySimulation: (runId: Id<"workRuns">) =>
-    saveDesign,
+      runOperation(() => retrySimulationMutation({ runId })),
-    selectProject,
+    saveDefinition: (workId: Id<"works">, payload: unknown) =>
-    selectedProject,
+      saveDefinitionMutation({ payloadJson: JSON.stringify(payload), workId }),
    saveDesign: (workId: Id<"works">, payload: unknown) =>
      saveDesignMutation({ payloadJson: JSON.stringify(payload), workId }),
    selectProject: (projectId: string) =>
      setSelectedProjectId(projectId as unknown as Id<"projects">),
    selectedProject: selectedProject
      ? { id: selectedProject.id, name: selectedProject.name }
      : null,
    setRepository,
-    startExecution,
+    startExecution: (workId: Id<"works">, sliceId?: string) =>
-    startSimulation,
+      runOperation(() => startExecutionMutation({ sliceId, workId })),
    startSimulation: (
      workId: Id<"works">,
      scenario: ExecutionScenario,
      sliceId?: string
    ) =>
      runOperation(() =>
        startSimulationMutation({ scenario, sliceId, workId })
      ),
    works,
-  } as const;
+  };
 };
--- a/apps/web/src/hooks/workspace/use-visual-viewport.test.ts
+++ b/apps/web/src/hooks/workspace/use-visual-viewport.test.ts
@@ -2,7 +2,7 @@ import { describe, expect, test } from "vitest";
 import { visualViewportStyle } from "./use-visual-viewport";
-describe("Slice 1 visual viewport", () => {
+describe("Workspace visual viewport", () => {
  test("shrinks the application surface to the keyboard-visible height", () => {
    expect(visualViewportStyle({ height: 500, offsetTop: 0 })).toEqual({
      height: "500px",
--- a/apps/web/src/hooks/workspace/use-visual-viewport.ts
+++ b/apps/web/src/hooks/workspace/use-visual-viewport.ts
@@ -33,7 +33,7 @@ export const useVisualViewportStyle = (): CSSProperties => {
      });
    };
-    root.classList.add("slice-one-viewport-lock");
+    root.classList.add("workspace-viewport-lock");
    update();
    window.addEventListener("resize", update);
    viewport?.addEventListener("resize", update);
@@ -41,7 +41,7 @@ export const useVisualViewportStyle = (): CSSProperties => {
    return () => {
      cancelAnimationFrame(animationFrame);
-      root.classList.remove("slice-one-viewport-lock");
+      root.classList.remove("workspace-viewport-lock");
      window.removeEventListener("resize", update);
      viewport?.removeEventListener("resize", update);
      viewport?.removeEventListener("scroll", update);
--- a/apps/web/src/index.css
+++ b/apps/web/src/index.css
@@ -6,8 +6,8 @@ body {
  min-height: 100%;
 }
-html.slice-one-viewport-lock,
+html.workspace-viewport-lock,
-html.slice-one-viewport-lock body {
+html.workspace-viewport-lock body {
  height: 100%;
  overflow: hidden;
  overscroll-behavior: none;
@@ -116,9 +116,9 @@ html.slice-one-viewport-lock body {
  color: var(--foreground);
 }
-.slice-one-surface .chat-markdown,
+.workspace-surface .chat-markdown,
-.slice-one-surface .chat-reasoning,
+.workspace-surface .chat-reasoning,
-.slice-one-surface .thinking-line {
+.workspace-surface .thinking-line {
  color: #232321;
 }
--- a/apps/web/src/lib/workspace/frontend-regressions.test.ts
+++ b/apps/web/src/lib/workspace/frontend-regressions.test.ts
@@ -5,27 +5,36 @@ import { describe, expect, test } from "vitest";
 const source = (relativePath: string) =>
  readFileSync(new URL(relativePath, import.meta.url), "utf-8");
-describe("Slice 1 frontend regression contracts", () => {
+describe("Workspace frontend regression contracts", () => {
  test("keeps keyboard resizing on the visual viewport instead of page scroll", () => {
-    const page = source("../../components/slice-one/slice-one-page.tsx");
+    const page = source(
      "../../components/workspace/project-workspace-page.tsx"
    );
    const viewport = source("../../hooks/workspace/use-visual-viewport.ts");
    const root = source("../../root.tsx");
    const styles = source("../../index.css");
    expect(root).toContain("interactive-widget=resizes-content");
    expect(page).toContain("style={viewportStyle}");
    expect(page).toContain("fixed inset-x-0 top-0");
-    expect(page).not.toContain("slice-one-surface flex h-svh");
+    expect(viewport).toContain("workspace-viewport-lock");
-    expect(styles).toContain("html.slice-one-viewport-lock body");
+    expect(styles).toContain("html.workspace-viewport-lock body");
    expect(styles).toContain("overflow: hidden");
  });
  test("keeps the responsive shell shrinkable with a pinned composer", () => {
-    const page = source("../../components/slice-one/slice-one-page.tsx");
+    const page = source(
      "../../components/workspace/project-workspace-page.tsx"
    );
    const feed = source("../../components/workspace/conversation-feed.tsx");
    const composer = source(
      "../../components/workspace/conversation-composer.tsx"
    );
    expect(page).toContain('className="flex min-w-0 flex-1 flex-col"');
-    expect(page).toContain('<Conversation className="min-h-0 flex-1">');
+    expect(feed).toContain('<Conversation className="min-h-0 flex-1">');
-    expect(page).toContain('className="shrink-0 border-t');
+    expect(composer).toContain('className="shrink-0 border-t');
-    expect(page).toContain(
+    expect(composer).toContain(
      'className="mx-auto flex max-w-2xl items-end gap-2"'
    );
  });
--- a/apps/web/src/lib/workspace/presentation.test.ts
+++ b/apps/web/src/lib/workspace/presentation.test.ts
@@ -3,7 +3,10 @@ import { describe, expect, test } from "vitest";
 import type { ConversationMessage } from "@/lib/chat/types";
-import { buildSliceOneTimeline, findSourceMessageTarget } from "./presentation";
+import {
  buildWorkspaceTimeline,
  findSourceMessageTarget,
 } from "./presentation";
 const textMessage = (
  id: string,
@@ -23,9 +26,9 @@ const notice: WorkNotice = {
  workId: "work-1",
 };
-describe("Slice 1 presentation", () => {
+describe("Workspace presentation", () => {
  test("places proposed Work after the assistant response to its source", () => {
-    const timeline = buildSliceOneTimeline(
+    const timeline = buildWorkspaceTimeline(
      [
        textMessage("user-1", "user", "Build the phone flow."),
        textMessage("assistant-1", "assistant", "Captured and proposed Work."),
--- a/apps/web/src/lib/workspace/presentation.ts
+++ b/apps/web/src/lib/workspace/presentation.ts
@@ -7,14 +7,9 @@ import {
 } from "@/lib/chat/transforms";
 import type { ConversationMessage } from "@/lib/chat/types";
-export type SliceTimelineItem =
+import type { WorkspaceTimelineItem } from "./types";
  | {
      readonly kind: "message";
      readonly message: ConversationMessage;
    }
  | { readonly kind: "work"; readonly notice: WorkNotice };
-export const isSliceOneVisibleMessage = (
+export const isVisibleConversationMessage = (
  message: ConversationMessage
 ): boolean =>
  message.role === "user" ||
@@ -42,11 +37,11 @@ const targetIndexForNotice = (
  return responseOffset === -1 ? sourceIndex : sourceIndex + responseOffset + 1;
 };
-export const buildSliceOneTimeline = (
+export const buildWorkspaceTimeline = (
  allMessages: readonly ConversationMessage[],
  notices: readonly WorkNotice[]
-): readonly SliceTimelineItem[] => {
+): readonly WorkspaceTimelineItem[] => {
-  const messages = allMessages.filter(isSliceOneVisibleMessage);
+  const messages = allMessages.filter(isVisibleConversationMessage);
  const noticesByMessageIndex = new Map<number, WorkNotice[]>();
  for (const notice of notices) {
    const targetIndex = targetIndexForNotice(messages, notice);
@@ -55,7 +50,7 @@ export const buildSliceOneTimeline = (
    noticesByMessageIndex.set(targetIndex, atTarget);
  }
-  const timeline: SliceTimelineItem[] = [];
+  const timeline: WorkspaceTimelineItem[] = [];
  for (const [index, message] of messages.entries()) {
    timeline.push({ kind: "message", message });
    for (const notice of noticesByMessageIndex.get(index) ?? []) {
--- a/apps/web/src/lib/workspace/types.ts
+++ b/apps/web/src/lib/workspace/types.ts
@@ -0,0 +1,163 @@
 import type { Id } from "@code/backend/convex/_generated/dataModel";
 import type { WorkNotice } from "@code/primitives/work";
 import type { ConversationMessage } from "@/lib/chat/types";
 export interface WorkRecord {
  readonly _id: Id<"works">;
  readonly title: string;
  readonly objective: string;
  readonly status: string;
  readonly definitionVersion?: number;
  readonly definitionApprovalVersion?: number;
  readonly designVersion?: number;
  readonly signals: readonly {
    readonly sources: readonly { messageId: string; rawText: string }[];
  }[];
  readonly runs: readonly WorkRun[];
  readonly definition: {
    readonly risk?: string;
    readonly questions?: readonly { status: string }[];
  } | null;
  readonly design: {
    readonly architectureSummary?: string;
    readonly slices?: readonly {
      readonly id: string;
      readonly title: string;
      readonly observableBehavior: string;
    }[];
  } | null;
 }
 export interface WorkRun {
  readonly artifacts?: readonly WorkArtifact[];
  readonly attemptEvents?: readonly WorkAttemptEvent[];
  readonly baseRevision?: string;
  readonly candidateRevision?: string;
  readonly executionKind?: string;
  readonly _id: Id<"workRuns">;
  readonly status: string;
  readonly terminalClassification?: string;
  readonly terminalSummary?: string;
 }
 export interface WorkArtifact {
  readonly _id: string;
  readonly metadataJson: string;
  readonly title: string;
  readonly uri?: string;
 }
 export interface WorkAttemptEvent {
  readonly _id: string;
  readonly message: string;
 }
 export interface GitConnection {
  readonly id: string;
  readonly provider: "github" | "gitea";
  readonly serverUrl: string;
  readonly username?: string;
 }
 export interface ProjectListItem {
  readonly id: string;
  readonly name: string;
 }
 export interface WorkspaceState {
  readonly agent: {
    readonly error?: Error;
    readonly historyReady: boolean;
    readonly messages: readonly ConversationMessage[];
    readonly sendMessage: (
      message: string,
      options?: { readonly images?: readonly File[] }
    ) => Promise<void>;
    readonly status:
      | "connecting"
      | "error"
      | "idle"
      | "streaming"
      | "submitted";
  };
  readonly approveDefinition: (
    workId: Id<"works">,
    version: number
  ) => Promise<unknown>;
  readonly approveDesign: (
    workId: Id<"works">,
    definitionVersion: number,
    designVersion: number
  ) => Promise<unknown>;
  readonly authorizeGithub: () => Promise<unknown>;
  readonly cancelExecution: (runId: Id<"workRuns">) => Promise<unknown>;
  readonly cancelSimulation: (runId: Id<"workRuns">) => Promise<unknown>;
  readonly clearOperationError: () => void;
  readonly connectGitea: (input: {
    readonly serverUrl: string;
    readonly token: string;
    readonly username?: string;
  }) => Promise<void>;
  readonly connectLinkedGithub: () => Promise<void>;
  readonly connectRepository: () => Promise<void>;
  readonly error?: Error;
  readonly gitConnections: readonly GitConnection[] | undefined;
  readonly operationError?: Error;
  readonly pending: boolean;
  readonly projectGitConnection: GitConnection | null | undefined;
  readonly projects: readonly ProjectListItem[] | undefined;
  readonly repository: string;
  readonly requestDefinition: (workId: Id<"works">) => Promise<unknown>;
  readonly retrySimulation: (runId: Id<"workRuns">) => Promise<unknown>;
  readonly saveDefinition: (
    workId: Id<"works">,
    payload: unknown
  ) => Promise<unknown>;
  readonly saveDesign: (
    workId: Id<"works">,
    payload: unknown
  ) => Promise<unknown>;
  readonly selectProject: (projectId: string) => void;
  readonly selectedProject: ProjectListItem | null;
  readonly setRepository: (value: string) => void;
  readonly startExecution: (
    workId: Id<"works">,
    sliceId?: string
  ) => Promise<unknown>;
  readonly startSimulation: (
    workId: Id<"works">,
    scenario:
      | "success"
      | "transient-failure-then-success"
      | "needs-input"
      | "permanent-failure"
      | "cancelled",
    sliceId?: string
  ) => Promise<unknown>;
  readonly works: readonly WorkRecord[] | undefined;
 }
 export type WorkspaceTimelineItem =
  | { readonly kind: "message"; readonly message: ConversationMessage }
  | { readonly kind: "work"; readonly notice: WorkNotice };
 export interface ArtifactMetadata {
  readonly changedFiles?: readonly string[];
 }
 export const parseArtifactMetadata = (
  artifact: WorkArtifact
 ): ArtifactMetadata => {
  if (!artifact.metadataJson) {
    return {};
  }
  try {
    return JSON.parse(artifact.metadataJson) as ArtifactMetadata;
  } catch {
    return {};
  }
 };
 export const changedFilesFor = (artifact: WorkArtifact): readonly string[] =>
  parseArtifactMetadata(artifact).changedFiles ?? [];
--- a/apps/web/src/routes.ts
+++ b/apps/web/src/routes.ts
@@ -7,7 +7,6 @@ export default [
    route("signup", "./routes/auth/signup/page.tsx"),
  ]),
  layout("./routes/app/layout.tsx", [
-    index("./routes/app/mobile/page.tsx"),
+    index("./routes/app/workspace/page.tsx"),
    route("dashboard", "./routes/app/dashboard/page.tsx"),
  ]),
 ] satisfies RouteConfig;
--- a/apps/web/src/routes/app/dashboard/page.tsx
+++ b/apps/web/src/routes/app/dashboard/page.tsx
@@ -1,5 +0,0 @@
 import { SliceOnePage } from "@/components/slice-one/slice-one-page";
 export default function Dashboard() {
  return <SliceOnePage />;
 }
--- a/apps/web/src/routes/app/mobile/page.tsx
+++ b/apps/web/src/routes/app/mobile/page.tsx
@@ -1,5 +0,0 @@
 import { SliceOnePage } from "@/components/slice-one/slice-one-page";
 export default function MobileLandingRedirect() {
  return <SliceOnePage />;
 }
--- a/apps/web/src/routes/app/workspace/page.tsx
+++ b/apps/web/src/routes/app/workspace/page.tsx
@@ -0,0 +1,5 @@
 import { ProjectWorkspacePage } from "@/components/workspace/project-workspace-page";
 export default function ProjectWorkspaceRoute() {
  return <ProjectWorkspacePage />;
 }
--- a/bun.lock
+++ b/bun.lock
--- a/deploy/zopu-runtime/.env.template
+++ b/deploy/zopu-runtime/.env.template
@@ -25,14 +25,7 @@ CONVEX_INSTANCE_NAME=zopu-production
 CONVEX_INSTANCE_SECRET=
 # ---------------------------------------------------------------------------
-# 2. Self-hosted Git / Gitea — REQUIRED for issue lifecycle
+# 2. Model gateway — REQUIRED
 #    The agent daemon clones repos and creates PRs through Gitea.
 # ---------------------------------------------------------------------------
 GITEA_URL=https://git.openputer.com
 GITEA_TOKEN=replace-with-gitea-api-token
 # ---------------------------------------------------------------------------
 # 3. Model gateway — REQUIRED
 #    All model calls route through this OpenAI-compatible endpoint.
 # ---------------------------------------------------------------------------
 AGENT_MODEL_PROVIDER=cheaptricks
@@ -44,17 +37,17 @@ AGENT_MODEL_CONTEXT_WINDOW=262000
 AGENT_MODEL_MAX_TOKENS=131072
 # ---------------------------------------------------------------------------
-# 4. AgentOS / Rivet Engine — REQUIRED for the execution runner
+# 3. AgentOS / Rivet Engine — REQUIRED for the execution runner
-#    The agent service and runner connect through the public engine endpoint.
+#    The runner creates isolated worktrees from ZOPU_SOURCE_REPOSITORY and
-#    RIVET_WORKSPACE_TOKEN authenticates every workspace actor connection.
+#    connects to AgentOS through the public engine endpoint.
 #    RIVET_ENVOY_VERSION must change for each runner deployment.
 # ---------------------------------------------------------------------------
 RIVET_ENDPOINT=https://default:@rivet.example.com
 RIVET_PUBLIC_ENDPOINT=https://default@rivet.example.com
 RIVET_ENVOY_VERSION=1
 RIVET_WORKSPACE_TOKEN=replace-with-a-long-random-workspace-token
 ZOPU_SOURCE_REPOSITORY=/opt/zopu-source
 # ---------------------------------------------------------------------------
-# 5. Zopu agent service (Flue)
+# 4. Zopu agent service (Flue)
 #    FLUE_DB_TOKEN authenticates the Flue persistence adapter.
 #    zopu-agent.service pins the Flue Node server to port 3583.
 # ---------------------------------------------------------------------------
@@ -62,7 +55,7 @@ FLUE_DB_TOKEN=replace-with-long-random-token
 AGENT_BACKEND_URL=https://zopu-agent.example.com
 # ---------------------------------------------------------------------------
-# 6. Daemon identity
+# 5. Daemon identity
 # ---------------------------------------------------------------------------
 DAEMON_ID=zopu-dedicated
 DAEMON_NAME=Zopu-Dedicated-Server
--- a/deploy/zopu-runtime/runner/Dockerfile
+++ b/deploy/zopu-runtime/runner/Dockerfile
@@ -5,7 +5,7 @@ FROM node:24-bookworm-slim
 COPY --from=bun /usr/local/bin/bun /usr/local/bin/bun
 RUN apt-get update \
-  && apt-get install -y --no-install-recommends g++ make python3 \
+  && apt-get install -y --no-install-recommends ca-certificates g++ git make python3 \
  && rm -rf /var/lib/apt/lists/*
 WORKDIR /app
--- a/deploy/zopu-runtime/runner/docker-compose.yml
+++ b/deploy/zopu-runtime/runner/docker-compose.yml
@@ -19,4 +19,11 @@ services:
      RIVET_ENVOY_VERSION: ${RIVET_ENVOY_VERSION}
      RIVET_WORKSPACE_TOKEN: ${RIVET_WORKSPACE_TOKEN}
      RIVET_POOL: default
      ZOPU_SOURCE_REPOSITORY: /opt/zopu-source
    volumes:
      - ../..:/opt/zopu-source
      - zopu-agentos-workspaces:/var/lib/zopu/workspaces
    restart: unless-stopped
 volumes:
  zopu-agentos-workspaces:
--- a/package.json
+++ b/package.json
@@ -1,59 +1,12 @@
 {
  "name": "code",
  "private": true,
  "workspaces": {
    "packages": [
      "apps/web",
      "packages/agents",
      "packages/auth",
      "packages/backend",
      "packages/config",
      "packages/env",
      "packages/primitives",
      "packages/ui"
    ],
    "catalog": {
      "@rivet-dev/agentos": "^0.2.7",
      "@rivet-dev/agentos-core": "^0.2.10",
      "@effect/platform-bun": "4.0.0-beta.99",
      "dotenv": "^17.4.2",
      "zod": "^4.4.3",
      "lucide-react": "^1.23.0",
      "next-themes": "^0.4.6",
      "react": "19.2.8",
      "react-dom": "19.2.8",
      "sonner": "^2.0.7",
      "convex": "^1.42.1",
      "better-auth": "1.6.15",
      "@convex-dev/better-auth": "^0.12.5",
      "@tanstack/react-form": "^1.33.0",
      "@types/react-dom": "^19.2.3",
      "tailwindcss": "^4.3.2",
      "tailwind-merge": "^3.6.0",
      "@better-auth/expo": "1.6.15",
      "effect": "4.0.0-beta.99",
      "typescript": "^6",
      "@types/bun": "latest",
      "heroui-native": "^1.0.5",
      "vite": "^7.3.6",
      "vitest": "^4.1.10",
      "convex-test": "^0.0.54",
      "react-native": "0.86.0",
      "@types/react": "^19.2.17",
      "@types/node": "^22.13.14",
      "hono": "^4.8.3",
      "valibot": "^1.4.2",
      "streamdown": "2.5.0",
      "@tailwindcss/postcss": "^4.3.2",
      "@tailwindcss/vite": "^4.3.2"
    }
  },
  "type": "module",
  "scripts": {
    "dev": "vp run -r dev",
    "build": "vp run -r build",
    "check-types": "vp run -r check-types",
-    "check": "ultracite check package.json vite.config.ts apps/web/package.json apps/web/src/root.tsx apps/web/src/index.css apps/web/src/components/chat apps/web/src/components/slice-one apps/web/src/hooks/chat apps/web/src/hooks/slice-one apps/web/src/lib/chat apps/web/src/lib/slice-one apps/web/src/routes.ts apps/web/src/routes/app/dashboard/page.tsx apps/web/src/routes/app/mobile/page.tsx packages/agents/package.json packages/agents/src/agents/zopu.ts packages/agents/src/app.ts packages/agents/src/auth.ts packages/agents/src/tools/slice-one.ts packages/backend/package.json packages/backend/convex/conversationMessages.ts packages/backend/convex/conversationMessages.test.ts packages/backend/convex/fluePersistence.test.ts packages/backend/convex/projects.ts packages/backend/convex/schema.ts packages/backend/convex/signalRouting.ts packages/backend/convex/signalRouting.test.ts packages/backend/convex/works.ts packages/backend/convex/works.test.ts packages/backend/convex/workArtifacts.ts packages/backend/convex/workArtifacts.test.ts packages/backend/convex/workExecution.ts packages/backend/convex/workExecution.test.ts packages/backend/convex/workPlanning.ts packages/backend/convex/workPlanning.test.ts packages/backend/convex/crons.ts packages/primitives/src/work.ts packages/primitives/src/work.test.ts packages/primitives/src/work-artifact.ts packages/primitives/src/work-artifact.test.ts packages/primitives/src/resolver.ts packages/primitives/src/work-lifecycle.ts packages/primitives/src/work-resolution.test.ts",
+    "check": "ultracite check package.json vite.config.ts apps/web/package.json apps/web/src/root.tsx apps/web/src/index.css apps/web/src/components/chat apps/web/src/components/workspace apps/web/src/hooks/chat apps/web/src/hooks/workspace apps/web/src/lib/chat apps/web/src/lib/workspace apps/web/src/routes.ts apps/web/src/routes/app/dashboard/page.tsx apps/web/src/routes/app/workspace/page.tsx packages/agents/package.json packages/agents/src/agents/zopu.ts packages/agents/src/app.ts packages/agents/src/auth.ts packages/agents/src/tools/slice-one.ts packages/backend/package.json packages/backend/convex/conversationMessages.ts packages/backend/convex/conversationMessages.test.ts packages/backend/convex/fluePersistence.test.ts packages/backend/convex/projects.ts",
    "lint": "oxlint --disable-nested-config",
    "format": "vp fmt",
    "staged": "vp staged",
@@ -65,14 +18,10 @@
    "dev:server": "vp run --filter @code/backend dev",
    "dev:setup": "vp run --filter @code/backend dev:setup",
    "build:agents": "vp run --filter @code/agents build",
-    "docs:update": "bun run scripts/update-docs.ts",
+    "docs:update": "node scripts/update-docs.ts",
-    "subtree": "bun run scripts/subtree.ts",
+    "subtree": "node scripts/subtree.ts",
-    "fix": "ultracite fix",
+    "fix": "ultracite fix"
    "slice1": "vp run -r dev",
    "dev:zopu": "vp run --filter @code/agents dev",
    "dev:zopu:web": "vp run --filter web dev"
  },
  "dependencies": {},
  "devDependencies": {
    "@code/backend": "workspace:*",
    "@code/config": "workspace:*",
@@ -84,18 +33,13 @@
    "convex": "catalog:",
    "convex-test": "catalog:",
    "effect": "catalog:",
-    "oxfmt": "latest",
+    "oxfmt": "0.61.0",
-    "oxlint": "latest",
+    "oxlint": "1.76.0",
    "rolldown": "1.1.4",
    "typescript": "catalog:",
    "ultracite": "7.9.3",
    "vite-plus": "0.2.2",
    "vitest": "catalog:"
  },
-  "overrides": {
+  "packageManager": "pnpm@11.17.0"
    "react": "19.2.8",
    "react-dom": "19.2.8",
    "vite": "npm:@voidzero-dev/vite-plus-core@0.2.2"
  },
  "packageManager": "bun@1.3.14"
 }
--- a/packages/agents/flue.config.ts
+++ b/packages/agents/flue.config.ts
@@ -1,5 +1,5 @@
-import { defineConfig } from '@flue/cli/config';
+import { defineConfig } from "@flue/cli/config";
 export default defineConfig({
-  target: 'node',
+  target: "node",
 });
--- a/packages/agents/package.json
+++ b/packages/agents/package.json
@@ -4,23 +4,24 @@
  "private": true,
  "type": "module",
  "scripts": {
-    "build": "bun --env-file=../../.env flue build",
+    "build": "node --env-file=../../.env node_modules/@flue/cli/bin/flue.mjs build",
    "start": "node --env-file=../../.env dist/server.mjs",
    "check-types": "tsc --noEmit",
-    "dev": "bun --env-file=../../.env flue dev",
+    "dev": "node --env-file=../../.env node_modules/@flue/cli/bin/flue.mjs dev",
-    "dev:tailscale": "bun --env-file=../../.env flue dev",
+    "dev:tailscale": "node --env-file=../../.env node_modules/@flue/cli/bin/flue.mjs dev",
-    "run": "bun --env-file=../../.env flue run",
+    "run": "node --env-file=../../.env node_modules/@flue/cli/bin/flue.mjs run",
-    "runner": "bun --env-file=../../.env src/runner.ts",
+    "runner": "node --env-file=../../.env src/runner.ts",
-    "run:zopu": "bun --env-file=../../.env flue run zopu",
+    "run:zopu": "node --env-file=../../.env node_modules/@flue/cli/bin/flue.mjs run zopu",
-    "run:work-planner": "bun --env-file=../../.env flue run work-planner"
+    "run:work-planner": "node --env-file=../../.env node_modules/@flue/cli/bin/flue.mjs run work-planner"
  },
  "dependencies": {
    "@agentos-software/codex-cli": "0.3.4",
    "@agentos-software/git": "0.3.3",
    "@code/backend": "workspace:*",
    "@code/env": "workspace:*",
    "@code/primitives": "workspace:*",
    "@flue/runtime": "latest",
-    "@rivet-dev/agentos": "0.2.10",
+    "@rivet-dev/agentos": "0.2.14",
    "@rivet-dev/agentos-core": "0.2.14",
    "convex": "catalog:",
    "hono": "catalog:",
    "rivetkit": "2.3.9",
@@ -30,6 +31,10 @@
    "@code/config": "workspace:*",
    "@flue/cli": "latest",
    "@types/bun": "catalog:",
    "@types/node": "catalog:",
    "typescript": "catalog:"
  },
  "engines": {
    "node": ">=22.18 <23 || >=23.6"
  }
 }
--- a/packages/agents/src/agents/zopu.ts
+++ b/packages/agents/src/agents/zopu.ts
@@ -1,54 +1,9 @@
 import { parseAgentEnv } from "@code/env/agent";
 import { defineAgent } from "@flue/runtime";
 import INSTRUCTIONS from "../prompts/zopu-instructions.md" with { type: "markdown" };
 import { createSliceOneTools } from "../tools/slice-one";
 const INSTRUCTIONS = `You are Zopu for product Slice 1 and the Work planning handoff.
 ## Your role
 The application stores each user message as exact evidence before you process it. You may interpret that evidence, but never supply, rewrite, or invent source text.
 ## Work routing loop
 When a user sends a message, follow this decision flow:
 1. **Assess actionability.** Does the message contain a concrete problem, request, blocker, opportunity, or decision that warrants a work unit? Greetings, questions about the system, casual conversation, and exploration do NOT create work. If the message is casual conversation, respond naturally and do nothing else.
   Direct questions, casual conversation, and image-reading requests must be answered immediately without calling any tools.
 2. **Identify project context.** Call list_projects. If there is one project, use it. If there are several and the request is ambiguous, ask one focused question.
 3. **Create a Signal (only when actionable).** When the message is actionable:
   a. Call list_signal_evidence to see the exact admitted user messages.
   b. Select the message IDs that compose the problem statement.
   c. Call create_signal with a structured problem statement (title, summary, desiredOutcome, constraints). The problem statement must faithfully represent the user's own intent. Do not invent scope they did not mention.
   d. Include the projectId when the project is known.
 4. **Route the Signal.** After creating the Signal:
   a. Call list_proposed_work for the project.
   b. If the Signal clearly describes the same desired outcome as existing Work, call attach_signal_to_work.
   c. Otherwise call create_work_from_signal.
   e. If genuinely uncertain whether to attach or create, ask one focused question.
 5. **Explain the outcome.** Tell the user clearly what happened:
   - "Captured [Signal title] and linked it to [Work title]."
   - "Captured [Signal title] and proposed [Work title]."
   - Keep the response brief; the product renders the durable Work card separately.
 ## Rules
 - Never supply or rewrite the raw source message text. The control plane copies it server-side.
 - You receive and can see images attached to the current user message. This model supports image input. Never claim images are unavailable, omitted, or unsupported. If a message has attached images, inspect them before responding.
 - Never create Work from casual chat.
 - Ask at most one focused clarification when genuinely ambiguous.
 - Preserve project and organization scope at all times.
 - Repeated delivery of the same message must not create duplicate Signals or attachments. The backend is idempotent.
 - Never claim you created a Signal until the tool call returns successfully.
 - Do not start implementation, planning, sandboxes, Git, verification, or delivery. Those are explicitly outside Slice 1.
   - After creating proposed Work, the system may invoke the private work-planner. Never claim that a Definition, Design, approval, or implementation exists unless Convex reports it.
   - Proposed Work is the only Work status you directly create.`;
 export {
  convexAgentRoute as attachments,
  convexAgentRoute as route,
--- a/packages/agents/src/prompts/zopu-instructions.md
+++ b/packages/agents/src/prompts/zopu-instructions.md
@@ -0,0 +1,45 @@
 You are Zopu for product Slice 1 and the Work planning handoff.
 ## Your role
 The application stores each user message as exact evidence before you process it. You may interpret that evidence, but never supply, rewrite, or invent source text.
 ## Work routing loop
 When a user sends a message, follow this decision flow:
 1. **Assess actionability.** Does the message contain a concrete problem, request, blocker, opportunity, or decision that warrants a work unit? Greetings, questions about the system, casual conversation, and exploration do NOT create work. If the message is casual conversation, respond naturally and do nothing else.
   Direct questions, casual conversation, and image-reading requests must be answered immediately without calling any tools.
 2. **Identify project context.** Call list_projects. If there is one project, use it. If there are several and the request is ambiguous, ask one focused question.
 3. **Create a Signal (only when actionable).** When the message is actionable:
   a. Call list_signal_evidence to see the exact admitted user messages.
   b. Select the message IDs that compose the problem statement.
   c. Call create_signal with a structured problem statement (title, summary, desiredOutcome, constraints). The problem statement must faithfully represent the user's own intent. Do not invent scope they did not mention.
   d. Include the projectId when the project is known.
 4. **Route the Signal.** After creating the Signal:
   a. Call list_proposed_work for the project.
   b. If the Signal clearly describes the same desired outcome as existing Work, call attach_signal_to_work.
   c. Otherwise call create_work_from_signal.
   e. If genuinely uncertain whether to attach or create, ask one focused question.
 5. **Explain the outcome.** Tell the user clearly what happened:
   - "Captured [Signal title] and linked it to [Work title]."
   - "Captured [Signal title] and proposed [Work title]."
   - Keep the response brief; the product renders the durable Work card separately.
 ## Rules
 - Never supply or rewrite the raw source message text. The control plane copies it server-side.
 - You receive and can see images attached to the current user message. This model supports image input. Never claim images are unavailable, omitted, or unsupported. If a message has attached images, inspect them before responding.
 - Never create Work from casual chat.
 - Ask at most one focused clarification when genuinely ambiguous.
 - Preserve project and organization scope at all times.
 - Repeated delivery of the same message must not create duplicate Signals or attachments. The backend is idempotent.
 - Never claim you created a Signal until the tool call returns successfully.
 - Do not start implementation, planning, sandboxes, Git, verification, or delivery. Those are explicitly outside Slice 1.
   - After creating proposed Work, the system may invoke the private work-planner. Never claim that a Definition, Design, approval, or implementation exists unless Convex reports it.
   - Proposed Work is the only Work status you directly create.
--- a/packages/agents/src/runtime/agent-os.ts
+++ b/packages/agents/src/runtime/agent-os.ts
@@ -1,36 +1,38 @@
 import { parseAgentEnv } from "@code/env/agent";
 import { agentOS, setup } from "@rivet-dev/agentos";
 import { createClient } from "@rivet-dev/agentos/client";
 import { Effect } from "effect";
 import {
  codexSessionEnv,
  makeCodexAgentOsConfig,
 } from "../../../primitives/src/agent-os";
 import {
  makePiAgentOsConfig,
  makePiHomeFiles,
  decodeWorkAttemptExecutionInput,
  WorkAttemptExecutionError,
-} from "../../../primitives/src/execution-runtime";
+  piSessionEnv,
 } from "@code/primitives";
 import type {
  ExecutionEvent,
  WorkAttemptExecutionResult,
-} from "../../../primitives/src/execution-runtime";
+} from "@code/primitives";
 import { agentOS, setup } from "@rivet-dev/agentos";
 import { createHostDirBackend } from "@rivet-dev/agentos-core";
 import { createClient } from "@rivet-dev/agentos/client";
 import { Effect } from "effect";
-const codexConfig = makeCodexAgentOsConfig();
+import { HostRepositoryWorkspace } from "./host-repository";
 const piConfig = makePiAgentOsConfig();
 const workspace = agentOS<undefined, { token: string }>({
  onBeforeConnect: (_context, params) => {
    if (params.token !== process.env.RIVET_WORKSPACE_TOKEN) {
      throw new Error("Unauthorized workspace connection");
    }
  },
-  software: codexConfig.software,
+  options: {
    actionTimeout: 10 * 60 * 1000,
  },
  permissions: piConfig.permissions,
  software: piConfig.software,
 });
 export const runtimeRegistry = setup({ use: { workspace } });
 const shellQuote = (value: string): string =>
  `'${value.replaceAll("'", `'"'"'`)}'`;
 const event = (
  sequence: number,
  kind: ExecutionEvent["kind"],
@@ -44,16 +46,6 @@ const event = (
  sequence,
 });
 const requireSuccess = (
  result: { exitCode: number; stderr: string; stdout: string },
  operation: string
 ) => {
  if (result.exitCode !== 0) {
    throw new Error(`${operation} failed: ${result.stderr || result.stdout}`);
  }
  return result.stdout.trim();
 };
 const executionError = (
  message: string,
  reason: WorkAttemptExecutionError["reason"],
@@ -80,12 +72,6 @@ const classifyRuntimeFailure = (cause: unknown): WorkAttemptExecutionError => {
  return executionError(message, "HarnessFailed", false);
 };
 const gitAuthEnv = (username: string, credential: string) => ({
  GIT_CONFIG_COUNT: "1",
  GIT_CONFIG_KEY_0: "http.extraHeader",
  GIT_CONFIG_VALUE_0: `Authorization: Basic ${Buffer.from(`${username}:${credential}`).toString("base64")}`,
 });
 export const executeAgentOsAttempt = async (
  rawInput: unknown
 ): Promise<WorkAttemptExecutionResult> => {
@@ -106,59 +92,95 @@ export const executeAgentOsAttempt = async (
        workspaceKey: input.workspaceKey,
      }),
    ];
-    const authEnv = gitAuthEnv(
+    const hostRepository = new HostRepositoryWorkspace();
-      input.auth.username ??
+    const prepared = await hostRepository.prepare({
-        (input.auth.provider === "github" ? "x-access-token" : "git"),
+      attemptId: input.attemptId,
-      input.auth.credential
+      piHomeFiles: makePiHomeFiles({
-    );
+        api: env.AGENT_MODEL_API,
-
+        apiKeyEnvironmentVariable: "AGENT_MODEL_API_KEY",
-    await vm.mkdir("/workspace", { recursive: true });
+        baseUrl: env.AGENT_MODEL_BASE_URL,
-    if (!(await vm.exists("/workspace/repository/.git"))) {
+        contextWindow: env.AGENT_MODEL_CONTEXT_WINDOW,
-      events.push(event(1, "repository.cloning", "Cloning project repository"));
+        maxTokens: env.AGENT_MODEL_MAX_TOKENS,
-      const clone = await vm.execArgv(
+        model: env.AGENT_MODEL_NAME,
-        "git",
+        provider: env.AGENT_MODEL_PROVIDER,
        ["clone", input.repositoryUrl, "/workspace/repository"],
        {
          cwd: "/workspace",
          env: authEnv,
        }
      );
      requireSuccess(clone, "Repository clone");
    }
    const checkout = await vm.exec(
      `git fetch origin ${shellQuote(input.baseBranch)} && git checkout -B ${shellQuote(`zopu/${input.runId}`)} ${shellQuote(`origin/${input.baseBranch}`)}`,
      { cwd: "/workspace/repository", env: authEnv }
    );
    requireSuccess(checkout, "Repository checkout");
    const baseRevision = requireSuccess(
      await vm.execArgv("git", ["rev-parse", "HEAD"], {
        cwd: "/workspace/repository",
      }),
-      "Base revision lookup"
+    });
    events.push(
      event(
        1,
        "runtime.preparing",
        prepared.created
          ? "Isolated Zopu worktree created on the execution host"
          : "Isolated Zopu worktree recreated"
      )
    );
    const mounts = [
      {
        hostPath: prepared.checkoutPath,
        path: "/workspace/repository",
        readOnly: false,
      },
      {
        hostPath: prepared.sourceRepositoryPath,
        path: prepared.sourceRepositoryPath,
        readOnly: false,
      },
      {
        hostPath: prepared.piHomePath,
        path: "/home/zopu",
        readOnly: false,
      },
      {
        hostPath: prepared.toolsPath,
        path: "/opt/zopu-tools",
        readOnly: true,
      },
    ] as const;
    const mountNext = async (index: number): Promise<void> => {
      const mount = mounts[index];
      if (!mount) {
        return;
      }
      try {
        await vm.mountFs({
          path: mount.path,
          plugin: createHostDirBackend({
            hostPath: mount.hostPath,
            readOnly: mount.readOnly,
          }),
          readOnly: mount.readOnly,
        });
      } catch (error) {
        const message = error instanceof Error ? error.message : String(error);
        throw executionError(
          `Failed to mount ${mount.hostPath} at ${mount.path}: ${message}`,
          "HarnessFailed",
          false
        );
      }
      await mountNext(index + 1);
    };
    await mountNext(0);
    const { baseRevision } = prepared;
    events.push(
      event(2, "repository.ready", "Repository checkout is ready", {
        baseRevision,
      })
    );
-    const sessionId = `codex-${input.attemptId}`;
+    const sessionId = `pi-${input.attemptId}`;
    await vm.openSession({
      additionalDirectories: [`${prepared.sourceRepositoryPath}/.git`],
      additionalInstructions:
-        "Work only inside /workspace/repository. Do not reveal credentials. Make the requested change and run focused verification. Do not push or open a pull request.",
+        "Work only inside /workspace/repository. This is an isolated worktree of the Zopu product repository. Read AGENTS.md and the relevant product specifications before changing code. Never reveal credentials, modify the read-only base checkout, push, or open a pull request. Implement the requested change and run focused verification.",
-      agent: "codex",
+      agent: "pi",
      cwd: "/workspace/repository",
-      env: codexSessionEnv({
+      env: piSessionEnv(env.AGENT_MODEL_API_KEY),
        apiKey: env.AGENT_MODEL_API_KEY,
        baseUrl: env.AGENT_MODEL_BASE_URL,
        model: env.AGENT_MODEL_NAME,
      }),
      permissionPolicy: "allow_all",
      sessionId,
    });
    events.push(
-      event(3, "harness.started", "Codex implementation session started")
+      event(3, "harness.started", "Pi implementation session started")
    );
    const promptResult = await vm.prompt({
      content: [{ text: input.prompt, type: "text" }],
@@ -169,68 +191,24 @@ export const executeAgentOsAttempt = async (
      const reason =
        promptResult.stopReason === "cancelled" ? "Cancelled" : "HarnessFailed";
      throw executionError(
-        `Codex stopped with ${promptResult.stopReason}`,
+        `Pi stopped with ${promptResult.stopReason}`,
        reason,
        promptResult.stopReason === "max_tokens" ||
          promptResult.stopReason === "max_turn_requests"
      );
    }
    events.push(
-      event(4, "harness.progress", "Codex implementation turn completed", {
+      event(4, "harness.progress", "Pi implementation turn completed", {
        stopReason: promptResult.stopReason,
      })
    );
-    const status = requireSuccess(
+    const collected = await HostRepositoryWorkspace.collect({
-      await vm.execArgv("git", ["status", "--porcelain"], {
+      attemptId: input.attemptId,
-        cwd: "/workspace/repository",
+      baseRevision,
-      }),
+      checkoutPath: prepared.checkoutPath,
-      "Changed file lookup"
+    });
-    );
+    const { candidateRevision, changedFiles, diff } = collected;
    const diff = requireSuccess(
      await vm.execArgv("git", ["diff", "--binary", "HEAD"], {
        cwd: "/workspace/repository",
      }),
      "Diff collection"
    );
    const changedFiles = status
      .split("\n")
      .filter(Boolean)
      .map((line) => line.slice(3).trim());
    let candidateRevision = baseRevision;
    if (changedFiles.length > 0) {
      requireSuccess(
        await vm.execArgv("git", ["add", "-A"], {
          cwd: "/workspace/repository",
        }),
        "Candidate staging"
      );
      const tree = requireSuccess(
        await vm.execArgv("git", ["write-tree"], {
          cwd: "/workspace/repository",
        }),
        "Candidate tree creation"
      );
      candidateRevision = requireSuccess(
        await vm.exec(
          `printf %s ${shellQuote(`Zopu candidate for ${input.attemptId}`)} | git commit-tree ${shellQuote(tree)} -p ${shellQuote(baseRevision)}`,
          {
            cwd: "/workspace/repository",
            env: {
              GIT_AUTHOR_EMAIL: "agent@zopu.dev",
              GIT_AUTHOR_NAME: "Zopu Agent",
              GIT_COMMITTER_EMAIL: "agent@zopu.dev",
              GIT_COMMITTER_NAME: "Zopu Agent",
            },
          }
        ),
        "Candidate revision creation"
      );
      requireSuccess(
        await vm.execArgv("git", ["reset"], { cwd: "/workspace/repository" }),
        "Candidate index reset"
      );
    }
    events.push(
      event(
        5,
@@ -252,8 +230,8 @@ export const executeAgentOsAttempt = async (
      events,
      summary:
        changedFiles.length > 0
-          ? `Codex changed ${changedFiles.length} file(s)`
+          ? `Pi changed ${changedFiles.length} file(s)`
-          : "Codex completed without repository changes",
+          : "Pi completed without repository changes",
    };
  } catch (error) {
    throw classifyRuntimeFailure(error);
@@ -273,5 +251,5 @@ export const cancelAgentOsAttempt = async (
    .getOrCreate([workspaceKey], {
      params: { token: env.RIVET_WORKSPACE_TOKEN },
    })
-    .cancelPrompt({ sessionId: `codex-${attemptId}` });
+    .cancelPrompt({ sessionId: `pi-${attemptId}` });
 };
--- a/packages/agents/src/runtime/host-repository.ts
+++ b/packages/agents/src/runtime/host-repository.ts
@@ -0,0 +1,274 @@
 import { execFileSync, spawn } from "node:child_process";
 import { createHash } from "node:crypto";
 import { once } from "node:events";
 import {
  access,
  chmod,
  copyFile,
  mkdir,
  rm,
  writeFile,
 } from "node:fs/promises";
 import path from "node:path";
 import type { PiHomeFiles } from "@code/primitives";
 interface PrepareRepositoryInput {
  attemptId: string;
  piHomeFiles: PiHomeFiles;
 }
 interface PreparedRepository {
  baseRevision: string;
  checkoutPath: string;
  created: boolean;
  piHomePath: string;
  sourceRepositoryPath: string;
  toolsPath: string;
 }
 interface CollectRepositoryInput {
  attemptId: string;
  baseRevision: string;
  checkoutPath: string;
 }
 interface CollectedRepository {
  candidateRevision: string;
  changedFiles: string[];
  diff: string;
 }
 interface ProcessResult {
  exitCode: number;
  stderr: string;
  stdout: string;
 }
 const requireSuccess = (result: ProcessResult, operation: string): string => {
  if (result.exitCode !== 0) {
    throw new Error(`${operation} failed: ${result.stderr || result.stdout}`);
  }
  return result.stdout.trim();
 };
 const changedFilePath = (line: string): string => {
  const filePath = line.slice(3).trim();
  const renameSeparator = " -> ";
  const renameIndex = filePath.lastIndexOf(renameSeparator);
  return renameIndex === -1
    ? filePath
    : filePath.slice(renameIndex + renameSeparator.length);
 };
 const runProcess = async (
  command: string,
  args: readonly string[],
  cwd: string,
  env: Record<string, string> = {}
 ): Promise<ProcessResult> => {
  const environment = Object.fromEntries(
    Object.entries(process.env).filter(
      (entry): entry is [string, string] => entry[1] !== undefined
    )
  );
  const child = spawn(command, args, {
    cwd,
    env: { ...environment, ...env },
  });
  const stderr: Uint8Array[] = [];
  const stdout: Uint8Array[] = [];
  child.stderr.on("data", (chunk: Uint8Array) => stderr.push(chunk));
  child.stdout.on("data", (chunk: Uint8Array) => stdout.push(chunk));
  const [exitCode] = await once(child, "close");
  return {
    exitCode: typeof exitCode === "number" ? exitCode : 1,
    stderr: Buffer.concat(stderr).toString(),
    stdout: Buffer.concat(stdout).toString(),
  };
 };
 const runGit = (cwd: string, args: readonly string[]) =>
  runProcess("git", args, cwd);
 const pathExists = async (target: string): Promise<boolean> => {
  try {
    await access(target);
    return true;
  } catch {
    return false;
  }
 };
 export class HostRepositoryWorkspace {
  readonly #root: string;
  readonly #sourceRepositoryPath: string;
  readonly #installDependencies: boolean;
  constructor(
    root = process.env.AGENT_WORKSPACE_ROOT ?? "/var/lib/zopu/workspaces",
    sourceRepositoryPath = process.env.ZOPU_SOURCE_REPOSITORY ??
      "/opt/zopu-source",
    installDependencies = true
  ) {
    this.#root = root;
    this.#sourceRepositoryPath = sourceRepositoryPath;
    this.#installDependencies = installDependencies;
  }
  async prepare(input: PrepareRepositoryInput): Promise<PreparedRepository> {
    if (!(await pathExists(path.join(this.#sourceRepositoryPath, ".git")))) {
      throw new Error(
        `Fixed Zopu source repository is unavailable at ${this.#sourceRepositoryPath}`
      );
    }
    const identity = createHash("sha256")
      .update(input.attemptId)
      .digest("hex")
      .slice(0, 24);
    const workspacePath = path.join(this.#root, identity);
    const checkoutPath = path.join(workspacePath, "repository");
    const toolsPath = path.join(workspacePath, "tools");
    const piHomePath = path.join(workspacePath, "home");
    const branch = `zopu/attempt-${identity}`;
    const created = !(await pathExists(path.join(checkoutPath, ".git")));
    await mkdir(workspacePath, { recursive: true });
    if (!created) {
      requireSuccess(
        await runGit(this.#sourceRepositoryPath, [
          "worktree",
          "remove",
          "--force",
          checkoutPath,
        ]),
        "Existing worktree removal"
      );
    }
    await rm(checkoutPath, { force: true, recursive: true });
    requireSuccess(
      await runGit(this.#sourceRepositoryPath, [
        "worktree",
        "add",
        "-B",
        branch,
        checkoutPath,
        "HEAD",
      ]),
      "Zopu worktree creation"
    );
    const bunExecutable =
      process.env.BUN_EXECUTABLE ??
      execFileSync("which", ["bun"], { encoding: "utf-8" }).trim();
    const sourceEnvPath = path.join(this.#sourceRepositoryPath, ".env");
    if (await pathExists(sourceEnvPath)) {
      await copyFile(sourceEnvPath, path.join(checkoutPath, ".env"));
    }
    if (this.#installDependencies) {
      requireSuccess(
        await runProcess(
          bunExecutable,
          ["install", "--frozen-lockfile"],
          checkoutPath,
          { CI: "1" }
        ),
        "Workspace dependency installation"
      );
    }
    const toolsBinPath = path.join(toolsPath, "bin");
    await mkdir(toolsBinPath, { recursive: true });
    const bunPath = path.join(toolsBinPath, "bun");
    await copyFile(bunExecutable, bunPath);
    await chmod(bunPath, 0o755);
    const piAgentPath = path.join(piHomePath, ".pi", "agent");
    await mkdir(piAgentPath, { recursive: true });
    await writeFile(
      path.join(piAgentPath, "models.json"),
      input.piHomeFiles.models
    );
    await writeFile(
      path.join(piAgentPath, "settings.json"),
      input.piHomeFiles.settings
    );
    return {
      baseRevision: requireSuccess(
        await runGit(checkoutPath, ["rev-parse", "HEAD"]),
        "Base revision lookup"
      ),
      checkoutPath,
      created,
      piHomePath,
      sourceRepositoryPath: this.#sourceRepositoryPath,
      toolsPath,
    };
  }
  static async collect(
    input: CollectRepositoryInput
  ): Promise<CollectedRepository> {
    const status = requireSuccess(
      await runGit(input.checkoutPath, ["status", "--porcelain"]),
      "Changed file lookup"
    );
    let diff = "";
    const changedFiles = status
      .split("\n")
      .filter(Boolean)
      .map(changedFilePath);
    let candidateRevision = input.baseRevision;
    if (changedFiles.length > 0) {
      requireSuccess(
        await runGit(input.checkoutPath, ["add", "-A"]),
        "Candidate staging"
      );
      diff = requireSuccess(
        await runGit(input.checkoutPath, [
          "diff",
          "--binary",
          "--cached",
          "--no-ext-diff",
          input.baseRevision,
        ]),
        "Diff collection"
      );
      const tree = requireSuccess(
        await runGit(input.checkoutPath, ["write-tree"]),
        "Candidate tree creation"
      );
      candidateRevision = requireSuccess(
        await runProcess(
          "git",
          [
            "commit-tree",
            tree,
            "-p",
            input.baseRevision,
            "-m",
            `Zopu candidate for ${input.attemptId}`,
          ],
          input.checkoutPath,
          {
            GIT_AUTHOR_EMAIL: "agent@zopu.dev",
            GIT_AUTHOR_NAME: "Zopu Agent",
            GIT_COMMITTER_EMAIL: "agent@zopu.dev",
            GIT_COMMITTER_NAME: "Zopu Agent",
          }
        ),
        "Candidate revision creation"
      );
      requireSuccess(
        await runGit(input.checkoutPath, ["reset"]),
        "Candidate index reset"
      );
    }
    return { candidateRevision, changedFiles, diff };
  }
 }
--- a/packages/backend/convex/schema.ts
+++ b/packages/backend/convex/schema.ts
@@ -367,7 +367,6 @@ export default defineSchema({
  workAttempts: defineTable({
    classification: v.optional(attemptClassification),
    endedAt: v.optional(v.number()),
    failureReason: v.optional(
      v.union(
        v.literal("Authentication"),
@@ -379,6 +378,7 @@ export default defineSchema({
        v.literal("Timeout")
      )
    ),
    endedAt: v.optional(v.number()),
    leaseExpiresAt: v.optional(v.number()),
    leaseOwner: v.optional(v.string()),
    number: v.number(),
--- a/packages/backend/convex/workExecutionAgent.ts
+++ b/packages/backend/convex/workExecutionAgent.ts
@@ -81,7 +81,7 @@ export const cancelAttempt = internalAction({
  handler: async (_ctx, args) => {
    // The workspace key remains the URL path segment (workspace identity),
    // while the body carries the attemptId so the runtime can target the
-    // codex session `codex-${attemptId}` for cancellation.
+    // matching Pi ACP session for cancellation.
    await fetch(
      `${backendUrl()}/internal/work-attempts/${encodeURIComponent(args.workspaceKey)}/cancel`,
      {
--- a/packages/backend/convex/workExecutionWorkflow.ts
+++ b/packages/backend/convex/workExecutionWorkflow.ts
@@ -430,7 +430,7 @@ export const completeAttempt = internalMutation({
      kind: "diff",
      metadataJson: JSON.stringify({ changedFiles: args.result.changedFiles }),
      organizationId: work.organizationId,
-      producer: "agentos-codex",
+      producer: "agentos-pi",
      projectId: work.projectId,
      provenanceJson: JSON.stringify({
        baseRevision: args.result.baseRevision,
--- a/packages/env/src/agent.ts
+++ b/packages/env/src/agent.ts
@@ -17,6 +17,7 @@ const agentEnvSchema = z.object({
  RIVET_ENDPOINT: z.url(),
  RIVET_PUBLIC_ENDPOINT: z.url().optional(),
  RIVET_WORKSPACE_TOKEN: z.string().min(32),
  ZOPU_SOURCE_REPOSITORY: z.string().min(1).default("/opt/zopu-source"),
 });
 export type AgentEnv = z.infer<typeof agentEnvSchema>;
--- a/packages/primitives/package.json
+++ b/packages/primitives/package.json
@@ -30,9 +30,9 @@
    "test:watch": "vitest"
  },
  "dependencies": {
-    "@agentos-software/codex": "0.2.7",
+    "@agentos-software/pi": "0.2.7",
    "@agentos-software/git": "0.3.3",
-    "@rivet-dev/agentos": "catalog:",
+    "@rivet-dev/agentos": "0.2.14",
    "effect": "catalog:"
  },
  "devDependencies": {
--- a/packages/primitives/src/agent-os.test.ts
+++ b/packages/primitives/src/agent-os.test.ts
@@ -1,25 +0,0 @@
 import { describe, expect, it } from "vitest";
 import { codexSessionEnv, makeCodexAgentOsConfig } from "./agent-os";
 describe("Codex agent-os config", () => {
  it("always includes the codex + git software bundle", () => {
    const config = makeCodexAgentOsConfig();
    expect(config.software).toHaveLength(2);
    expect(config.software?.[0]).toBeTypeOf("object");
  });
  it("builds model-provider session env", () => {
    const env = codexSessionEnv(
      {
        apiKey: "sk-test",
        baseUrl: "https://ai.example.com/v1",
        model: "glm-5.2",
      },
      { CODEX_MODEL: "glm-5.2" }
    );
    expect(env.OPENAI_API_KEY).toBe("sk-test");
    expect(env.OPENAI_BASE_URL).toBe("https://ai.example.com/v1");
    expect(env.CODEX_MODEL).toBe("glm-5.2");
  });
 });
--- a/packages/primitives/src/agent-os.ts
+++ b/packages/primitives/src/agent-os.ts
@@ -1,5 +1,5 @@
 /* eslint-disable max-classes-per-file -- the AgentOS service and its tagged error form one adapter contract. */
-import codex from "@agentos-software/codex";
+import pi from "@agentos-software/pi";
 import { agentOS as createAgentOsActor } from "@rivet-dev/agentos";
 import type { AgentOSConfigInput } from "@rivet-dev/agentos";
 import { Context, Effect, Layer, Schema } from "effect";
@@ -73,51 +73,94 @@ export const createAgentOsActorEffect = Effect.fn("createAgentOsActorEffect")(
 );
 // ---------------------------------------------------------------------------
-// Codex harness configuration
+// Pi harness configuration
 //
-// The canonical execution registry runs exactly one AgentOS actor for the
+// Slice 5 intentionally runs one harness against the server's fixed Zopu
-// puter/zopu-code repo, booted with the Codex CLI harness + git. The model
+// checkout. Pi speaks ACP natively and reads its model gateway from a mounted
-// provider is injected as VM env (OpenAI-compatible base URL + key) so Codex
+// HOME, avoiding a second executable adapter or credentials path.
 // authenticates against the configured gateway without a second credentials
 // path. This is a pure config builder; the RivetKit registry/server that hosts
 // the actor lives in the agents package.
 // ---------------------------------------------------------------------------
-/** Software bundle for a Codex-capable VM: the Codex harness plus git. */
+/** Software bundle for a Pi-capable VM: the Pi ACP harness plus git. */
-export const codexSoftware = [codex, getExecutableGitSoftware()] as const;
+export const piSoftware = [pi, getExecutableGitSoftware()] as const;
-/** Model-provider env that Codex reads inside the VM. Pass this to the session's
+export interface PiModelConfig {
- * `env` when opening a Codex session (`agent: "codex"`). */
+  readonly api: "openai-completions";
-export interface CodexModelEnv {
+  readonly apiKeyEnvironmentVariable: string;
  readonly apiKey: string;
  readonly baseUrl: string;
  readonly contextWindow: number;
  readonly maxTokens: number;
  readonly model: string;
  readonly provider: string;
 }
-/** Builds the VM env record Codex reads to authenticate against the model gateway. */
+export interface PiHomeFiles {
-export const codexSessionEnv = (
+  readonly models: string;
-  model: CodexModelEnv,
+  readonly settings: string;
 }
 /** Builds the two files Pi reads from ~/.pi/agent. */
 export const makePiHomeFiles = (model: PiModelConfig): PiHomeFiles => ({
  models: JSON.stringify(
    {
      providers: {
        [model.provider]: {
          api: model.api,
          apiKey: model.apiKeyEnvironmentVariable,
          authHeader: true,
          baseUrl: model.baseUrl,
          models: [
            {
              contextWindow: model.contextWindow,
              id: model.model,
              maxTokens: model.maxTokens,
              name: model.model,
            },
          ],
        },
      },
    },
    null,
    2
  ),
  settings: JSON.stringify(
    {
      defaultModel: model.model,
      defaultProvider: model.provider,
      quietStartup: true,
    },
    null,
    2
  ),
 });
 /** Environment supplied to the Pi ACP session. */
 export const piSessionEnv = (
  apiKey: string,
  extra: Readonly<Record<string, string>> = {}
 ): Record<string, string> => ({
-  CODEX_MODEL: model.model,
+  AGENT_MODEL_API_KEY: apiKey,
-  OPENAI_API_KEY: model.apiKey,
+  HOME: "/home/zopu",
-  OPENAI_BASE_URL: model.baseUrl,
+  PATH: "/opt/zopu-tools/bin:/usr/local/bin:/usr/bin:/bin",
  ...extra,
 });
-export interface CodexAgentOsConfigInput {
+export interface PiAgentOsConfigInput {
-  /** Extra software merged after the Codex+git bundle. */
+  /** Extra software merged after the Pi+git bundle. */
  readonly software?: NonNullable<AgentOSConfigInput<undefined>["software"]>;
  /** VM permission overrides merged over the execution policy. */
  readonly permissions?: AgentOSConfigInput<undefined>["permissions"];
 }
-/**
+export const makePiAgentOsConfig = (
- * Builds an AgentOS actor config for a Codex-backed VM. The Codex CLI and git
+  input: PiAgentOsConfigInput = {}
 * are always present; software the caller passes is appended, never replacing
 * the harness or git. Model-provider env is supplied per session via
 * `codexSessionEnv`, not here — the actor config has no env field.
 */
 export const makeCodexAgentOsConfig = (
  input: CodexAgentOsConfigInput = {}
 ): AgentOSConfigInput<undefined> => ({
-  software: [...codexSoftware, ...(input.software ?? [])],
+  permissions: {
    childProcess: "allow",
    env: "allow",
    fs: "allow",
    network: "allow",
    process: "allow",
    ...input.permissions,
  },
  software: [...piSoftware, ...(input.software ?? [])],
 });
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -0,0 +1,62 @@
 packages:
  - apps/web
  - packages/agents
  - packages/auth
  - packages/backend
  - packages/config
  - packages/env
  - packages/primitives
  - packages/ui
 allowBuilds:
  "@google/genai": true
  "@mongodb-js/zstd": true
  better-sqlite3: true
  cbor-extract: true
  esbuild: true
  isolated-vm: true
  koffi: true
  msgpackr-extract: true
  node-liblzma: true
  protobufjs: true
  workerd: true
 catalog:
  "@rivet-dev/agentos": "0.2.14"
  "@rivet-dev/agentos-core": "0.2.14"
  "@effect/platform-bun": "4.0.0-beta.99"
  dotenv: "17.4.2"
  zod: "4.4.3"
  lucide-react: "1.27.0"
  next-themes: "0.4.6"
  react: "19.2.8"
  react-dom: "19.2.8"
  sonner: "2.0.7"
  convex: "1.42.3"
  better-auth: "1.6.15"
  "@convex-dev/better-auth": "0.12.5"
  "@tanstack/react-form": "1.33.2"
  "@types/react-dom": "19.2.3"
  tailwindcss: "4.3.3"
  tailwind-merge: "3.6.0"
  "@better-auth/expo": "1.6.15"
  effect: "4.0.0-beta.99"
  typescript: "7.0.2"
  "@types/bun": "1.3.14"
  heroui-native: "1.0.6"
  vite: "8.1.5"
  vitest: "4.1.10"
  convex-test: "0.0.54"
  react-native: "0.86.0"
  "@types/react": "19.2.17"
  "@types/node": "22.20.1"
  hono: "4.12.32"
  valibot: "1.4.2"
  streamdown: "2.5.0"
  "@tailwindcss/postcss": "4.3.3"
  "@tailwindcss/vite": "4.3.3"
 overrides:
  react: "19.2.8"
  react-dom: "19.2.8"
  vite: "npm:@voidzero-dev/vite-plus-core@0.2.2"
Author	SHA1	Message	Date
-Puter	d8a4bbe804	chore cleanp	2026-07-29 01:24:37 +05:30
-Puter	9eb6bcd25f	refactor canonical components and remove slice 1	2026-07-29 01:24:16 +05:30
-Puter	a907539810	flue refactor and migrations	2026-07-29 00:45:46 +05:30
-Puter	601aca73c2	pnpm migrations	2026-07-29 00:45:33 +05:30
-Puter	ffecff3857	Run fixed Zopu worktrees with Pi	2026-07-28 22:20:42 +05:30
-Puter	0d7162544b	fix: run AgentOS workspaces on remote runner	2026-07-28 20:08:46 +05:30
-Puter	092a9793ea	fix: resolve repository hosts outside AgentOS	2026-07-28 18:30:08 +05:30
-Puter	5ee0a8d50e	fix: allow AgentOS process environment	2026-07-28 18:27:16 +05:30
-Puter	420676f2d7	fix: allow AgentOS command execution	2026-07-28 18:21:31 +05:30
-Puter	24d82e2a06	fix: allow AgentOS workspace filesystem	2026-07-28 18:18:24 +05:30
-Puter	d47fa0e96a	fix: allow slow AgentOS workspace boot	2026-07-28 18:14:32 +05:30
-Puter	1e7c893985	fix: apply AgentOS runtime permissions	2026-07-28 17:49:41 +05:30
-Puter	f9ebcb4a01	fix: align AgentOS runtime packages	2026-07-28 17:40:40 +05:30
-Puter	dceaa2b417	fix: allow AgentOS outbound networking	2026-07-28 17:29:47 +05:30
-Puter	a4f121e190	chore: preserve work attempt schema order	2026-07-28 17:12:54 +05:30