/trust-fabric/access) opens with four numbers:
the permissions in the catalog, how many are elevated, how many an agent may never hold, and the
share Forge checks somewhere. The grid below is compact, with the five verbs beside each resource
and each family as a colored band. Every cell prints how many roles include the permission and is
shaded to match. An amber ring marks an elevated permission, a robot with a slash marks one an
agent may never hold, and a verb a resource lacks is left blank. See
Access.GET /api/v2/factories/listCodebaseFiles is unchanged.github.com for git only, never GitHub’s API. Forge opens the pull request and reads its checks itself, so nothing in a run changes, but the agent inside the VM can no longer merge a pull request with the platform token.When an agent’s merge waits for approval, the approval now shows the repository, the pull-request number and the exact commit it would merge. Only a person can approve it; an External App cannot.Published workflows behave as before.GET /api/v2/workflows/listDebugFiles (and forge_list_workflow_debug_files) now leaves out a file
that carries a company the caller does not hold workflows:use at, the same rule
getDebugFileUrl already applied to its download, and a file whose record no longer exists. A key
could previously see such a file’s name, type and size in the list without being able to download it.factories:manage at the platform is asked in My Work, and only a person’s Approve moves it on. A move into an approved state without that decision is refused with FOREMAN_APPROVAL_REQUIRED. An approval is voided when the plan or request is sent back or edited in GitHub or Linear.A Personal key decides it through completeHumanTask like any human task, when its scopes reach both approvals:approve and factories:manage; human tasks of kind foreman_approval appear in listMyWork and getHumanTask.POST /api/v2/workforce/linkPersonIdentity and the forge_link_person_identity MCP tool now link
Freshservice identities, which were previously refused. Send provider: "freshservice" with the
synchronized Freshservice Knowledge source (freshserviceSourceId), the org unit it is homed at
(orgUnitId) and the technician (technicianId). As in the Console, you need knowledge:read at
that org unit, and the identity is derived from the source’s account, so the API and the Console
link the same identity for the same technician. See
Link person identity.- An approved Foreman plan stays approved only while its request does. When a person rejects the request, or it moves to
pendingorwon't_do, the plan goes back toplanningand the Foreman must submit it again. A change to the request’s title, description, risk tier or priority asks a person again. - Running
sdlc-implement-taskruns launched for a plan or request whose approval was voided are cancelled. - Restarting an
sdlc-implement-taskrun needs the plan or request to be approved now. OtherwisePOST /api/v2/runs/restartanswers a 409 namingapproval_required, andforge_restart_runreturns the same reason. - GitHub and Linear send a request’s priority only when the issue’s priority changes.
- When a person demotes a synthesized primitive, agents see only a fixed code and the reviewer’s feedback in a fenced, attributed notice. They never see the raw text.
POST /api/v2/knowledge/sources/create,
now schedules its first sync in the same step, audited as knowledge_source_sync_requested by
whoever created it. It no longer waits up to five minutes for the next dispatch. The dispatcher
still finds the source due, and the run it schedules starts nothing while the first run holds the
source, so a source never has two runs. Until the first run begins, the source drawer shows
First sync queued; the sources table shows First sync started until a run finishes. See
External knowledge sources.network capability call is refused with CAPABILITY_DENIED when its URL, headers
or body contain the procedure’s own session token as written, the bearer the procedure uses to call
back into Forge. Nothing is sent, the refusal is recorded on the run, and the record never stores the
token. This catches a token sent by mistake; it cannot stop procedure code that encodes the token
before sending it, and it does not cover a procedure’s direct egress to its own allowlisted hosts.
Network calls carry only what the procedure itself sends; Forge adds no credential to them.secrets_store capability, even when the
procedure’s manifest lists it in capabilities, and it can call only the operations Forge admits for
each capability: network.fetch, the file routes, the knowledge reads, typed judgments and the
project-management task and project operations. Operations that would return a platform credential,
such as an inference provider’s route or a source-control token, are never reachable. Such a call is refused with CAPABILITY_DENIED
before anything is read, so knowing a secret’s id never lets a procedure resolve, rotate, store or
revoke it. Procedures keep using vendor credentials as before, through their connections: the
sandbox applies a credential to a request for its own host without the procedure ever holding the
value. No published procedure in production or staging declared secrets_store.GET /api/v2/runs/getMarkdown (and forge_get_run_markdown) bounds each read of a step’s
transcript to the read room the request has left, and stops the transcript when that room runs out. A run
whose transcripts are larger than one request can read now returns the Markdown it could read with
meta.partial: true instead of a 500./api/v2/synthesis/* manage what the Console’s Synthesis Settings and
Synthesis Templates pages manage: list, create, update and delete the synthesis templates the Spec
Linter checks Builder drafts against, read and set the workspace’s synthesis budget, and read and
set the JIT synthesis default for new Workflow Architect channels. Reads need platform:read and
writes need synthesis:manage and platform:read, all at the platform scope. A constraint the
Spec Linter would skip as malformed is refused. The Forge MCP server adds eight matching tools to
its governance group. See Synthesis settings.x-goog-api-key header instead of
the URL.
