Skip to content

Commit 3ce432c

Browse files
t3dotggclaude
andcommitted
feat: pin favorite projects and archive old ones
Pinned projects come first in every project picker. Archived projects leave the pickers; threads and files are kept. Pin and archive live on the project record and are written to every machine's copy. Co-Authored-By: Claude Opus 5.5 <[email protected]>
1 parent 8d94203 commit 3ce432c

43 files changed

Lines changed: 587 additions & 71 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎apps/mobile/src/features/home/HomeScreen.tsx‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ import {
99
type EnvironmentProject,
1010
type EnvironmentThreadShell,
1111
} from "@t3tools/client-runtime/state/shell";
12+
import { pickableProjectGroups } from "@t3tools/client-runtime/state/project-grouping";
1213
import { threadSearchMatchKey } from "@t3tools/client-runtime/state/thread-search";
1314
import { type EnvironmentId, type SidebarProjectGroupingMode } from "@t3tools/contracts";
1415
import { useAtomValue } from "@effect/atom-react";
@@ -706,7 +707,10 @@ export function HomeScreen(props: HomeScreenProps) {
706707
<ThreadListFilters
707708
gutter={primaryColumn ? 8 : 0}
708709
environments={props.environments}
709-
projects={projectScopes.map((scope) => ({ key: scope.key, label: scope.title }))}
710+
projects={pickableProjectGroups(projectScopes).map((scope) => ({
711+
key: scope.key,
712+
label: scope.title,
713+
}))}
710714
selectedEnvironmentId={props.selectedEnvironmentId}
711715
selectedProjectKey={props.selectedProjectKey}
712716
onEnvironmentChange={props.onEnvironmentChange}

‎apps/mobile/src/features/home/homeThreadList.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,8 @@ export interface HomeProjectScope {
2727
readonly representative: EnvironmentProject;
2828
readonly projects: ReadonlyArray<EnvironmentProject>;
2929
readonly projectRefs: ReadonlyArray<ScopedProjectRef>;
30+
readonly pinned: boolean;
31+
readonly archived: boolean;
3032
}
3133

3234
function getProjectSortTimestamp(
@@ -62,6 +64,8 @@ export function buildHomeProjectScopes(input: {
6264
representative: group.representative,
6365
projects: group.members.map((member) => member.project),
6466
projectRefs: group.memberProjectRefs,
67+
pinned: group.pinned,
68+
archived: group.archived,
6569
};
6670
});
6771
}

‎apps/mobile/src/features/keyboard/CommandPalette.tsx‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -367,7 +367,11 @@ export function CommandPalette(props: {
367367
})),
368368
);
369369
}
370-
const projectItems: CommandPaletteItem[] = projects.map((project) => ({
370+
const openProjects = projects.filter((project) => project.archivedAt == null);
371+
const projectItems: CommandPaletteItem[] = [
372+
...openProjects.filter((project) => project.pinnedAt != null),
373+
...openProjects.filter((project) => project.pinnedAt == null),
374+
].map((project) => ({
371375
key: `project:${scopedProjectKey(project.environmentId, project.id)}`,
372376
kind: "project",
373377
project,

‎apps/mobile/src/features/settings/SettingsProjectOverviewRouteScreen.tsx‎

Lines changed: 61 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,10 @@ import {
99
isAtomCommandInterrupted,
1010
squashAtomCommandFailure,
1111
} from "@t3tools/client-runtime/state/runtime";
12-
import { deriveProjectGroupLabel } from "@t3tools/client-runtime/state/project-grouping";
12+
import {
13+
deriveProjectGroupLabel,
14+
type ProjectGroup,
15+
} from "@t3tools/client-runtime/state/project-grouping";
1316
import type { EnvironmentProject } from "@t3tools/client-runtime/state/shell";
1417
import { useNavigation } from "@react-navigation/native";
1518
import { useRef, useState } from "react";
@@ -34,6 +37,7 @@ import { useAtomCommand } from "../../state/use-atom-command";
3437
import { SettingsScreen } from "./components/SettingsScreen";
3538
import { SettingsSection } from "./components/SettingsSection";
3639
import { SettingsActionRow } from "./components/SettingsActionRow";
40+
import { SettingsSwitchRow } from "./components/SettingsSwitchRow";
3741
import {
3842
AndroidSettingsEnvironmentFilter,
3943
SettingsEnvironmentFilterHeader,
@@ -59,6 +63,7 @@ export function SettingsProjectOverviewRouteScreen() {
5963
};
6064
const navigation = useNavigation();
6165
const {
66+
availableTargets,
6267
selectedTargets,
6368
projectGroups,
6469
selectedProjectKey,
@@ -95,7 +100,7 @@ export function SettingsProjectOverviewRouteScreen() {
95100
<Text className="px-2 text-base text-foreground-muted">
96101
Choose a project with the filter above to manage its name, checkouts and removal.
97102
</Text>
98-
) : members.length === 0 ? (
103+
) : !group || members.length === 0 ? (
99104
<Text className="px-2 text-base text-foreground-muted">
100105
This project has no checkout on the selected connected environments. Change the filter
101106
above.
@@ -104,6 +109,8 @@ export function SettingsProjectOverviewRouteScreen() {
104109
<ProjectOverviewContent
105110
key={`${selectedProjectKey}:${members.map((member) => member.id).join(",")}`}
106111
members={members}
112+
group={group}
113+
connectedTargets={availableTargets}
107114
environments={selectedTargets}
108115
hasOtherMembers={members.length < (group?.members.length ?? 0)}
109116
isRemoving={isRemoving}
@@ -122,6 +129,9 @@ export function SettingsProjectOverviewRouteScreen() {
122129

123130
function ProjectOverviewContent(props: {
124131
readonly members: readonly EnvironmentProject[];
132+
/** Pin and archive belong to the whole project, even when the filter picks one machine. */
133+
readonly group: ProjectGroup;
134+
readonly connectedTargets: readonly SettingsTarget[];
125135
readonly environments: readonly SettingsTarget[];
126136
readonly hasOtherMembers: boolean;
127137
readonly isRemoving: boolean;
@@ -149,6 +159,31 @@ function ProjectOverviewContent(props: {
149159
label: "project name update",
150160
reportFailure: true,
151161
});
162+
const organizeProject = useAtomCommand(projectEnvironment.update, {
163+
label: "project update",
164+
reportFailure: true,
165+
});
166+
const [isOrganizing, setIsOrganizing] = useState(false);
167+
const allMembers = props.group.members.map((member) => member.project);
168+
// Older servers drop pin and archive, so their projects do not offer them.
169+
const canOrganize =
170+
canRemoveGroup &&
171+
allMembers.every(
172+
(member) =>
173+
props.connectedTargets.find((entry) => entry.environmentId === member.environmentId)
174+
?.serverConfig.environment.capabilities.projectOrganization === true,
175+
);
176+
const organize = (input: { readonly pinned?: boolean; readonly archived?: boolean }) => {
177+
setIsOrganizing(true);
178+
void Promise.all(
179+
allMembers.map((member) =>
180+
organizeProject({
181+
environmentId: member.environmentId,
182+
input: { projectId: member.id, ...input },
183+
}),
184+
),
185+
).finally(() => setIsOrganizing(false));
186+
};
152187
const nextName = (draftName ?? displayName).trim();
153188
const canSave = !isSaving && nextName.length > 0 && nextName !== displayName;
154189

@@ -295,6 +330,30 @@ function ProjectOverviewContent(props: {
295330
</View>
296331
</SettingsSection>
297332

333+
{canOrganize ? (
334+
<SettingsSection title="Organize">
335+
<SettingsSwitchRow
336+
icon="pin"
337+
label="Pin"
338+
subtitle="Pinned projects come first in project pickers."
339+
value={props.group.pinned}
340+
disabled={isOrganizing}
341+
onValueChange={(pinned) => organize({ pinned })}
342+
/>
343+
<SettingsActionRow
344+
icon="archivebox"
345+
label={props.group.archived ? "Unarchive project" : "Archive project"}
346+
description={
347+
props.group.archived
348+
? "Hidden from project pickers. Threads and files are kept."
349+
: "Hides the project from project pickers. Threads and files are kept."
350+
}
351+
disabled={isOrganizing}
352+
onPress={() => organize({ archived: !props.group.archived })}
353+
/>
354+
</SettingsSection>
355+
) : null}
356+
298357
<SettingsSection title="Checkouts">
299358
{props.members.map((member, index) => {
300359
const environment = props.environments.find(

‎apps/mobile/src/features/threads/NewTaskRouteScreen.tsx‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ import {
1111
} from "@react-navigation/native";
1212
import { SymbolView } from "../../components/ui/AppSymbol";
1313
import { availableScratchWorkspaceRoot } from "@t3tools/client-runtime/operations/projects";
14+
import { pickableProjectGroups } from "@t3tools/client-runtime/state/project-grouping";
1415
import { isScratchProject } from "@t3tools/client-runtime/state/projects";
1516
import {
1617
isAtomCommandInterrupted,
@@ -172,7 +173,7 @@ export function NewTaskRouteScreen({ route }: StaticScreenProps<NewTaskRoutePara
172173
const screenTitle = incomingShare ? "Start a task" : "Choose project";
173174
const projectEmptyState = deriveProjectEmptyState(catalogState);
174175
const serverConfigs = useServerConfigs();
175-
const listScopes = projectScopes.filter(
176+
const listScopes = pickableProjectGroups(projectScopes).filter(
176177
(scope) =>
177178
!scope.projects.every((project) =>
178179
isScratchProject(project, serverConfigs.get(project.environmentId)?.scratchWorkspaceRoot),

‎apps/mobile/src/features/threads/ThreadNavigationSidebar.tsx‎

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,10 @@
11
import { useActiveNewTask } from "../../state/active-new-task";
22
import { ThreadUndoNotice } from "../home/ThreadUndoNotice";
33
import { useAndroidControlSizing } from "../../components/ui/useAndroidControlSizing";
4-
import { resolveScratchProjectScopeKey } from "@t3tools/client-runtime/state/project-grouping";
4+
import {
5+
pickableProjectGroups,
6+
resolveScratchProjectScopeKey,
7+
} from "@t3tools/client-runtime/state/project-grouping";
58
import {
69
useAppearancePreferences,
710
useAndroidFloatingTabs,
@@ -213,7 +216,7 @@ function ThreadNavigationSidebarPane(
213216
}),
214217
[projects, options.selectedEnvironmentId, options.projectGroupingMode],
215218
);
216-
const projectFilterOptions = projectScopes.map((scope) => ({
219+
const projectFilterOptions = pickableProjectGroups(projectScopes).map((scope) => ({
217220
key: scope.key,
218221
label: scope.title,
219222
}));

‎apps/mobile/src/features/threads/new-task-project-selection.test.ts‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,8 @@ function makeScope(projects: ReadonlyArray<EnvironmentProject>): HomeProjectScop
5151
environmentId: project.environmentId,
5252
projectId: project.id,
5353
})),
54+
pinned: false,
55+
archived: false,
5456
};
5557
}
5658

‎apps/server/src/environment/ServerEnvironment.ts‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -257,6 +257,7 @@ export const make = Effect.gen(function* () {
257257
threadStop: true,
258258
environmentIcon: true,
259259
projectCloneTracking: true,
260+
projectOrganization: true,
260261
ignoredFileListing: true,
261262
...(serverSelfUpdate === null ? {} : { serverSelfUpdate }),
262263
...(serverInstallation === null ? {} : { serverInstallation }),

‎apps/server/src/orchestration-v2/ProjectCommands.test.ts‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,8 @@ const row = (overrides: Partial<ProjectRow> = {}): ProjectRow => ({
2323
faviconPath: null,
2424
projectIcon: null,
2525
scripts: [],
26+
pinnedAt: null,
27+
archivedAt: null,
2628
createdAt: "2026-01-01T00:00:00.000Z",
2729
updatedAt: "2026-01-01T00:00:00.000Z",
2830
deletedAt: null,
@@ -77,6 +79,38 @@ describe("planProjectCommand", () => {
7779
);
7880
});
7981

82+
it("keeps the first pin and archive time, and clears both on undo", () => {
83+
const earlier = "2025-12-01T00:00:00.000Z";
84+
const update = (project: ProjectRow, change: { pinned?: boolean; archived?: boolean }) =>
85+
payloadOf(
86+
plan(
87+
{
88+
type: "project.meta.update",
89+
commandId: CommandId.make("cmd-organize"),
90+
projectId,
91+
...change,
92+
},
93+
{ project },
94+
),
95+
);
96+
assert.deepInclude(update(row(), { pinned: true, archived: true }), {
97+
pinnedAt: "2026-01-01T00:00:00.000Z",
98+
archivedAt: "2026-01-01T00:00:00.000Z",
99+
});
100+
const organized = row({ pinnedAt: earlier, archivedAt: earlier });
101+
assert.deepInclude(update(organized, { pinned: true, archived: true }), {
102+
pinnedAt: earlier,
103+
archivedAt: earlier,
104+
});
105+
assert.deepInclude(update(organized, { pinned: false, archived: false }), {
106+
pinnedAt: null,
107+
archivedAt: null,
108+
});
109+
const untouched = update(organized, {});
110+
assert.notProperty(untouched, "pinnedAt");
111+
assert.notProperty(untouched, "archivedAt");
112+
});
113+
80114
it("rejects a workspace root held by another active project", () => {
81115
const owner = row({
82116
projectId: ProjectId.make("project-existing"),

‎apps/server/src/orchestration-v2/ProjectCommands.ts‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,8 @@ export interface ProjectMetaUpdateCommand {
3737
readonly faviconPath?: string | null;
3838
readonly projectIcon?: ProjectIconOverride | null;
3939
readonly scripts?: ReadonlyArray<ProjectScript>;
40+
readonly pinned?: boolean;
41+
readonly archived?: boolean;
4042
}
4143

4244
export interface ProjectDeleteCommand {
@@ -208,6 +210,13 @@ export function planProjectCommand(input: {
208210
...(command.faviconPath === undefined ? {} : { faviconPath: command.faviconPath }),
209211
...(command.projectIcon === undefined ? {} : { projectIcon: command.projectIcon }),
210212
...(command.scripts === undefined ? {} : { scripts: command.scripts }),
213+
// Repeating a pin or archive keeps the original time.
214+
...(command.pinned === undefined
215+
? {}
216+
: { pinnedAt: command.pinned ? (project.pinnedAt ?? occurredAt) : null }),
217+
...(command.archived === undefined
218+
? {}
219+
: { archivedAt: command.archived ? (project.archivedAt ?? occurredAt) : null }),
211220
updatedAt: occurredAt,
212221
},
213222
});

0 commit comments

Comments
 (0)