@markjaquith/agency 2.43.1 → 2.44.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markjaquith/agency",
-  "version": "2.43.1",
+  "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
 			}