@markjaquith/agency 2.73.2 → 2.74.0

package/README.md

@@ -631,7 +631,7 @@ included in generated or executed pull request commands.
 
 ### Target Context
 
-`agency context [target] --json` returns complete bootstrap context without
+`agency context [target] --json` returns compact bootstrap context without
 modifying the workbase or fetching repositories. At the workbase root it returns
 a discovery catalog of all epics, tasks, and phases, including frontmatter,
 paths, and document revisions. Elsewhere it returns context for an epic, task,
@@ -642,15 +642,15 @@ explicitly marked with `target.archived: true` and never grants writable
 document, repository checkout, or reference authority; restore the item before
 attempting mutation or execution.
 
-Root discovery is compact by default and includes a hint to run `agency context
-. --full --json` when document prose is needed. Entity context remains complete
-by default. `--compact` explicitly requests compact entity context.
+Root discovery and entity context are compact by default. Root discovery includes
+a hint to run `agency context . --full --json` when document prose is needed.
+`--compact` remains available as an explicit request for the compact projection.
 
-The result includes workbase and target identity, ancestor frontmatter and prose
-with SHA-256 hashes, dependency and readiness state, aggregate status, writable
-and reference authority, local checkout and resolved-commit state, recorded PR
-state, and validation warnings. Only `done` satisfies a dependency; `dropped` is
-terminal but remains a blocker.
+The result includes workbase and target identity, ancestor frontmatter with
+SHA-256 hashes, dependency and readiness state, aggregate status, writable and
+reference authority, local materialization state, recorded PR state, and
+validation warnings. Only `done` satisfies a dependency; `dropped` is terminal
+but remains a blocker.
 
 `authority.writable` identifies the writable repository checkout, while
 `authority.documents.writable` lists the absolute paths of Agency documents the
@@ -658,10 +658,9 @@ target may maintain. A single-phase task lists its `TASK.md`; a phase lists its
 owning `TASK.md` and active `PHASE.md`; orchestration targets list none. Use
 Agency commands rather than direct edits for structural frontmatter mutations.
 
-Complete output is the default for entity targets. Pass `--compact` explicitly
-to omit document prose and low-level Git details while retaining identity,
-hashes, authority, paths, graph state, materialization state, and validation
-warnings.
+Pass `--full` to include document prose and low-level VCS details. Compact output
+retains identity, hashes, authority, paths, graph state, materialization state,
+recorded PR state, and validation warnings.
 
 ### Workbase Graph
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markjaquith/agency",
-  "version": "2.73.2",
+  "version": "2.74.0",
   "description": "Manage agentic work across repositories with durable workbases",
   "keywords": [
     "agents",

package/src/commands/context.test.ts

@@ -161,9 +161,9 @@ Phase prose.
 		await cleanupTempDir(root)
 	})
 
-	test("returns complete phase context with graph, authority, Git, and validation state", async () => {
+	test("returns full phase context with graph, authority, Git, and validation state", async () => {
 		const target = "tasks/agent-contract/phases/context-command"
-		const result = await readContext(root, target)
+		const result = await readContext(root, target, false, true)
 
 		expect(result).toMatchObject({
 			projection: "complete",
@@ -273,7 +273,7 @@ status: working
 		const currentCommit = (await new Response(current.stdout).text()).trim()
 		expect(await current.exited).toBe(0)
 
-		const result = await readContext(root, "tasks/example")
+		const result = await readContext(root, "tasks/example", false, true)
 		expect(result.workspace.writable).toMatchObject({
 			branchCommit: null,
 			checkoutCommit: currentCommit,
@@ -286,14 +286,19 @@ status: working
 		)
 	})
 
-	test("makes compact projection explicit without omitting essential identity", async () => {
+	test("defaults to compact while preserving explicit compact compatibility", async () => {
 		const result = await readContext(
 			root,
 			"tasks/agent-contract/phases/context-command/code/agency",
+		)
+		const explicit = await readContext(
+			root,
+			"tasks/agent-contract/phases/context-command/code/agency",
 			true,
 		)
 
 		expect(result.projection).toBe("compact")
+		expect(explicit).toEqual(result)
 		expect(result.target.kind).toBe("phase")
 		expect(result.documents.phase.body).toBeUndefined()
 		expect(result.documents.phase.data.branch).toBe("feat/context")
@@ -441,7 +446,7 @@ status: dropped
 			join(root, "archive/tasks/foundations"),
 		)
 
-		const result = await readContext(root, "foundations")
+		const result = await readContext(root, "foundations", false, true)
 
 		expect(result.target).toMatchObject({
 			kind: "task",
@@ -488,6 +493,8 @@ status: dropped
 		const result = await readContext(
 			root,
 			"archive/tasks/agent-contract/phases/context-command",
+			false,
+			true,
 		)
 
 		expect(result.target).toMatchObject({
@@ -529,7 +536,7 @@ status: dropped
 			)
 		}
 
-		const result = await readContext(root, "epics/contract")
+		const result = await readContext(root, "epics/contract", false, true)
 
 		expect(result.target).toMatchObject({
 			kind: "epic",

package/src/commands/context.ts

@@ -21,16 +21,16 @@ export const context = (options: ContextOptions = {}) =>
 export const help = `
 Usage: agency context [target] [options]
 
-Return complete, read-only context for a workbase, epic, task, or phase. The
-target defaults to the current directory and may be the workbase root, an entity
-path, or a task ID. Archived entities are inspectable but never receive mutation
-or execution authority. Workbase context catalogs all active epics, tasks, and
-phases.
+Return read-only context for a workbase, epic, task, or phase. Compact output is
+the default. The target defaults to the current directory and may be the workbase
+root, an entity path, or a task ID. Archived entities are inspectable but never
+receive mutation or execution authority. Workbase context catalogs all active
+epics, tasks, and phases.
 
 Options:
   --json              Output a versioned machine result
-  --compact           Omit prose bodies and low-level Git details
-  --full              Include prose bodies in root workbase context
+  --compact           Use compact output (default)
+  --full              Include prose bodies and low-level VCS details
   --epic <id>         Select an epic
   --task <id>         Select a task
   --phase <id>        Select a phase together with --task

package/src/services/ContextService.ts

@@ -1239,9 +1239,10 @@ export class ContextService extends Effect.Service<ContextService>()(
 								? "complete"
 								: "partial"
 
+					const compact = !options.full
 					const projectDocument = <T>(document: Document<T> | null) =>
 						document
-							? options.compact
+							? compact
 								? {
 										id: document.id,
 										path: document.path,
@@ -1255,7 +1256,7 @@ export class ContextService extends Effect.Service<ContextService>()(
 						(task?.data && "repo" in task.data ? task.data : null)
 
 					return {
-						projection: options.compact ? "compact" : "complete",
+						projection: compact ? "compact" : "complete",
 						workbase: {
 							root,
 							configPath: join(root, "agency.json"),
@@ -1308,7 +1309,7 @@ export class ContextService extends Effect.Service<ContextService>()(
 								writable: writableDocuments,
 							},
 						},
-						workspace: options.compact
+						workspace: compact
 							? {
 									codePath,
 									materialization,

package/src/services/IntegrationService.test.ts

@@ -186,6 +186,10 @@ describe("IntegrationService", () => {
 		}
 		expect(managedWorkbaseAgents).toContain("agency push --json")
 		expect(managedWorkbaseAgents).toContain("agency-execution-v1")
+		expect(managedWorkbaseAgents).toContain("agency context . --full --json")
+		expect(managedWorkbaseAgents).toContain(
+			"Workers use full context here because they need the assigned document prose",
+		)
 		expect(managedWorkbaseAgents).toContain(
 			"Never pass `--work` or `--auto` to `agency task create`",
 		)

package/src/workbase/AGENTS.md

@@ -79,10 +79,11 @@ commands without prescribing an execution environment.
 Start every session with one read-only command:
 
 ```bash
-agency context . --json
+agency context . --full --json
 ```
 
-Use the returned target, document paths and revisions, dependency readiness,
+Workers use full context here because they need the assigned document prose. Use
+the returned target, document paths and revisions, dependency readiness,
 authority, checkout state, PR state, and validation result. Do not infer these
 from directory names or stale prose.