Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion crates/forge-core/src/collab/parity.rs
Original file line number Diff line number Diff line change
Expand Up @@ -202,7 +202,7 @@ impl Collab<'_> {
super::check_text("milestone description", description, 1000, 2000)?;
if repo.visibility == crate::rules::v2::Visibility::Private {
return Err(Error::Config(
"milestones in a private repository are sealed; this build does not seal them yet (use the web app)".into(),
"milestones in a private repository are sealed; no Forge client seals them yet (web or dg)".into(),
));
}
let p = milestone_props(title, description, due_on, closed);
Expand Down
17 changes: 16 additions & 1 deletion docs/guides/collaborating.md
Original file line number Diff line number Diff line change
Expand Up @@ -340,6 +340,21 @@ dg label delete <owner>/<repo> bug # deletes your definitions; r
dg issue label <owner>/<repo> 12 --add bug
```

On the web, **Issues → Labels** lists them and lets members create one, change its colour or description, and delete it (with the same retire-if-others-defined-it rule). A label keeps its name once defined: issues carry a label by its name, so a rename would leave them under the old one.

### Milestones

Members (maintainers and writers) define milestones and put issues in them:

```sh
dg milestone create <owner>/<repo> v1.0 --description "First release" --due 2026-12-01
dg milestone list <owner>/<repo>
dg milestone close <owner>/<repo> v1.0 # --reopen to reopen
dg issue milestone <owner>/<repo> 12 v1.0
```

On the web, **Issues → Milestones** lists them open and closed, with due dates and progress, and lets members create, edit, close, reopen and delete them. Like a label, a milestone keeps its title once defined. A milestone definition can be deleted only by the member who wrote it, so one another member also defined can be closed but not deleted. Milestones in a private repository are sealed, which this release does not do yet (web or `dg`).

### Stars

```sh
Expand All @@ -356,7 +371,7 @@ On forge.dashhq.org, signed in with a limited key ([Identity and keys](identity-
| You can | Not yet (coming soon) |
|---|---|
| Browse code, commits, branches, tags and PR diffs; download a branch as a zip | Web editing of files |
| File issues, comment, close and reopen; label them (members) | Merging a private repository's PRs, or committing to its branches (use `dg`) |
| File issues, comment, close and reopen; label them and put them in milestones, and manage the repo's labels and milestones (members) | Merging a private repository's PRs, or committing to its branches (use `dg`) |
| Open a PR from a branch you have already pushed, in the repository or your fork | Merging when both sides changed the same files (use `dg pr merge`) |
| Review a PR: approve, request changes or comment, with inline comments, suggestions and a pending review | |
| Merge a PR (see below) | |
Expand Down
14 changes: 14 additions & 0 deletions forge-web/app/repo/labels/client.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
'use client'

import { RepoScaffold } from '@/components/repo/repo-scaffold'
import { LabelsContent } from '@/components/repo/labels-content'
import { useRepoAddress } from '@/hooks/use-query-param'

export function LabelsClient(): JSX.Element {
const addr = useRepoAddress()
return (
<RepoScaffold addr={addr} rail={false}>
{(home) => <LabelsContent home={home} addr={addr} />}
</RepoScaffold>
)
}
11 changes: 11 additions & 0 deletions forge-web/app/repo/labels/page.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
import { QueryPage } from '@/components/route-loading'
import { LabelsClient } from './client'

/** `/repo/labels?owner=&name=` — the repo's labels: list, create, edit, delete (QW-019). */
export default function LabelsPage(): JSX.Element {
return (
<QueryPage wide>
<LabelsClient />
</QueryPage>
)
}
14 changes: 14 additions & 0 deletions forge-web/app/repo/milestones/client.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
'use client'

import { RepoScaffold } from '@/components/repo/repo-scaffold'
import { MilestonesContent } from '@/components/repo/milestones-content'
import { useRepoAddress } from '@/hooks/use-query-param'

export function MilestonesClient(): JSX.Element {
const addr = useRepoAddress()
return (
<RepoScaffold addr={addr} rail={false}>
{(home) => <MilestonesContent home={home} addr={addr} />}
</RepoScaffold>
)
}
11 changes: 11 additions & 0 deletions forge-web/app/repo/milestones/page.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
import { QueryPage } from '@/components/route-loading'
import { MilestonesClient } from './client'

/** `/repo/milestones?owner=&name=` — the repo's milestones: open / closed, progress, create, edit, close, delete (QW-019). */
export default function MilestonesPage(): JSX.Element {
return (
<QueryPage wide>
<MilestonesClient />
</QueryPage>
)
}
4 changes: 3 additions & 1 deletion forge-web/components/repo/issue-content.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ import { useSdk } from '@/hooks/use-sdk'
import { useAsync } from '@/hooks/use-async'
import { useIntent } from '@/hooks/use-intent'
import { useFirstWrite } from '@/hooks/use-first-write'
import { useParam, type RepoAddress } from '@/hooks/use-query-param'
import { repoHref, useParam, type RepoAddress } from '@/hooks/use-query-param'
import { useRepoLinks } from '@/components/repo/target-href'
import { importedUrlOf } from '@/lib/view/ref-targets'
import { CopyLinkButton } from '@/components/ui/copy-link'
Expand Down Expand Up @@ -492,6 +492,7 @@ export function IssueContent({ home, addr, number }: { home: RepoHome; addr?: Re
canDefine={!isPrivate}
canEdit={isMember && !archived && guard.disabledReason === null}
onChoose={(title) => setPending({ kind: 'milestone', title })}
{...(addr ? { manageHref: repoHref('/repo/milestones', addr) } : {})}
/>
</SidebarSection>
{isMember || meta.pinned || meta.locked ? (
Expand All @@ -517,6 +518,7 @@ export function IssueContent({ home, addr, number }: { home: RepoHome; addr?: Re
canEdit={isMember && !archived && guard.disabledReason === null}
onToggle={(label, remove) => setPending({ kind: 'label', label, remove })}
onDefine={(name, color, description) => setPending({ kind: 'defineLabel', name, color, description, apply: true })}
{...(addr ? { manageHref: repoHref('/repo/labels', addr) } : {})}
/>
{isPrivate ? <p className="mt-2 text-[12px] text-anvil-500 dark:text-anvil-400">The labels on this issue are encrypted; the label definitions (names, colours, descriptions) are not.</p> : null}
</SidebarSection>
Expand Down
2 changes: 2 additions & 0 deletions forge-web/components/repo/issues-content.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -81,6 +81,7 @@ import {
import { IssueTemplatePicker } from '@/components/repo/issue-templates'
import { useRepoTotals } from '@/components/repo/use-repo-totals'
import { useMilestones } from '@/components/repo/use-milestones'
import { TriageNav } from '@/components/repo/triage-nav'
import { BodyCounter, SealedLimit, composeCost, privateComposeBlock } from '@/components/repo/private-compose'
import type { RepoAddress } from '@/hooks/use-query-param'
import { repoHref } from '@/hooks/use-query-param'
Expand Down Expand Up @@ -143,6 +144,7 @@ export function IssuesContent({ home, addr }: { home: RepoHome; addr: RepoAddres
<div className="mx-auto max-w-4xl">
<div className="mb-3 flex flex-wrap items-center justify-between gap-3">
<SearchBox id="issue-search" label="Search issues" search={search} placeholder="is:open label:bug author:@me" />
<TriageNav addr={addr} />
{canCompose ? (
<Button variant="primary" size="sm" onClick={() => setComposing(true)} disabled={archived} title={archived ? ARCHIVED_REASON : undefined}>
<MessageSquarePlus className="h-3.5 w-3.5" aria-hidden /> New issue
Expand Down
Loading
Loading