@markjaquith/agency 2.43.0 → 2.44.0

package/README.md

@@ -95,6 +95,8 @@ orchestration, loads Agency's hidden instructions in addition to any user-owned
 root `AGENTS.md`, advertises the complete workbase as one portable reference,
 and replaces the built-in Plan agent with `agency-plan`. That planning agent can
 update `TASK.md`, `PHASE.md`, and `EPIC.md` while other edits remain disabled.
+When the subagent launches work in another agent, it verifies that the runner
+started and returns without waiting for the task to finish.
 OpenCode discovers the config from task and epic launch directories. Agents
 receive whole-workbase visibility from that reference. Bash and Agency operations
 must still follow the write authority reported by `agency context`.

package/package.json

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

package/src/commands/integration.test.ts

@@ -59,6 +59,29 @@ describe("integration command", () => {
 		expect(logs.join("\n")).toContain("global config")
 	})
 
+	test("formats integration status for people", async () => {
+		const logs = await captureLogs(() =>
+			runTestEffect(integration({ subcommand: "status", cwd: root })),
+		)
+
+		expect(logs.join("\n")).toBe(`Integration status: ${root}
+
+Agent instructions: missing
+  Path: .agency/AGENTS.md
+  Managed workbase instructions need synchronization.
+  Action: Run 'agency integration sync' to restore managed instructions.
+
+OpenCode config: missing
+  Path: .opencode/opencode.jsonc
+  Agency OpenCode launches cannot load current Agency instructions or whole-workbase access.
+  Action: Run 'agency integration sync' to install Agency instructions and whole-workbase OpenCode access.
+
+OpenCode /agency command: missing
+  Path: .opencode/command/agency.md
+  The managed OpenCode /agency command needs synchronization.
+  Action: Run 'agency integration sync' to install the managed /agency command.`)
+	})
+
 	test("explicitly synchronizes integration files", async () => {
 		const logs = await captureLogs(() =>
 			runTestEffect(integration({ subcommand: "sync", cwd: root, json: true })),
@@ -78,4 +101,24 @@ describe("integration command", () => {
 			await Bun.file(join(root, ".opencode/command/agency.md")).exists(),
 		).toBe(true)
 	})
+
+	test("formats integration sync results for people", async () => {
+		const logs = await captureLogs(() =>
+			runTestEffect(integration({ subcommand: "sync", cwd: root })),
+		)
+
+		expect(logs.join("\n")).toBe(`Integration sync: ${root}
+
+Agent instructions: synced
+  Path: .agency/AGENTS.md
+  Managed workbase instructions are current.
+
+OpenCode config: synced
+  Path: .opencode/opencode.jsonc
+  Agency's managed OpenCode launch config is ready to load Agency instructions and provide whole-workbase read access.
+
+OpenCode /agency command: synced
+  Path: .opencode/command/agency.md
+  Agency's managed OpenCode /agency command is current.`)
+	})
 })

package/src/commands/integration.ts

@@ -1,4 +1,5 @@
 import { Effect } from "effect"
+import { relative } from "node:path"
 import type { BaseCommandOptions } from "../utils/command"
 import { IntegrationService } from "../services/IntegrationService"
 import { createLoggers } from "../utils/effect"
@@ -8,6 +9,41 @@ interface IntegrationOptions extends BaseCommandOptions {
 	readonly json?: boolean
 }
 
+interface IntegrationResult {
+	readonly root: string
+	readonly files: readonly {
+		readonly name: "agents" | "opencode" | "opencode-command"
+		readonly path: string
+		readonly state: string
+		readonly diagnostic: string
+		readonly remediation: string | null
+		readonly changed?: boolean
+	}[]
+}
+
+const integrationNames = {
+	agents: "Agent instructions",
+	opencode: "OpenCode config",
+	"opencode-command": "OpenCode /agency command",
+} as const
+
+const logHumanResult = (
+	log: (message: string) => void,
+	subcommand: "status" | "sync",
+	result: IntegrationResult,
+) => {
+	log(`Integration ${subcommand}: ${result.root}`)
+	for (const file of result.files) {
+		log("")
+		log(
+			`${integrationNames[file.name]}: ${file.changed ? "synced" : file.state}`,
+		)
+		log(`  Path: ${relative(result.root, file.path)}`)
+		log(`  ${file.diagnostic}`)
+		if (file.remediation) log(`  Action: ${file.remediation}`)
+	}
+}
+
 export const integration = (options: IntegrationOptions) =>
 	Effect.gen(function* () {
 		const service = yield* IntegrationService
@@ -21,10 +57,7 @@ export const integration = (options: IntegrationOptions) =>
 					log(JSON.stringify(result, null, 2))
 					return
 				}
-				for (const file of result.files) {
-					log(`${file.name}\t${file.state}\t${file.path}\t${file.diagnostic}`)
-					if (file.remediation) log(`  Remediation: ${file.remediation}`)
-				}
+				logHumanResult(log, "status", result)
 				return
 			}
 
@@ -34,12 +67,7 @@ export const integration = (options: IntegrationOptions) =>
 					log(JSON.stringify(result, null, 2))
 					return
 				}
-				for (const file of result.files) {
-					log(
-						`${file.name}\t${file.changed ? "synced" : file.state}\t${file.path}\t${file.diagnostic}`,
-					)
-					if (file.remediation) log(`  Remediation: ${file.remediation}`)
-				}
+				logHumanResult(log, "sync", result)
 				return
 			}
 

package/src/services/IntegrationService.test.ts

@@ -172,6 +172,12 @@ describe("IntegrationService", () => {
 		expect(config.agent.agency.permission).toBeUndefined()
 		expect(config.agent.agency.hidden).toBeUndefined()
 		expect(config.agent.agency.steps).toBeUndefined()
+		expect(config.agent.agency.prompt).toContain(
+			"verify that the runner started successfully",
+		)
+		expect(config.agent.agency.prompt).toContain(
+			"return without waiting for the task to finish",
+		)
 		expect(config.references).toEqual({
 			workbase: {
 				path: "..",

package/src/workbase/opencode-file.ts

@@ -21,7 +21,7 @@ const body = () =>
 						"Handles Agency workbase orchestration and workflow operations with the Agency CLI",
 					mode: "subagent",
 					prompt:
-						"You are the Agency workflow specialist. Use the Agency CLI to handle delegated workbase orchestration and workflow operations. Always start with `agency context . --json`, follow the managed Agency instructions and reported authority, use Agency commands for durable mutations, and report the resulting state concisely.",
+						"You are the Agency workflow specialist. Use the Agency CLI to handle delegated workbase orchestration and workflow operations. Always start with `agency context . --json`, follow the managed Agency instructions and reported authority, use Agency commands for durable mutations, and report the resulting state concisely. When delegated to start or kick off work in another agent, launch it, verify that the runner started successfully, and return without waiting for the task to finish.",
 				},
 				plan: {
 					disable: true,