@mono-agent/agent-app 0.9.0 → 0.10.0

package/README.md

@@ -261,6 +261,11 @@ mono-agent memory inspect --json
 mono-agent memory retry --json
 mono-agent memory retry <64-character-id> --json
 mono-agent memory resolve <64-character-id> <reason-slug> --json
+
+# Explicit BuJo cleanup: prepare is read-only; apply/restore require stop.
+mono-agent memory forget prepare --ids-file ./forget-ids.txt --reason noise_cleanup --plan ./forget-plan.json --json
+mono-agent memory forget apply --plan ./forget-plan.json --json
+mono-agent memory forget restore --backup /path/returned/by/apply --json
 ```
 
 Journal and BuJo always require a valid managed `.index/manifest.json`; only
@@ -277,7 +282,14 @@ generated configs, or an authored Ollama block). The advanced standalone
 `retry` makes dead/delayed intake due for the
 next store start; `resolve` explicitly abandons one item without claiming
 capture succeeded, keeps permanent duplicate protection, and refuses a retained
-semantic plan.
+semantic plan. `forget prepare` accepts at most 32 ids and writes an owner-only,
+single-link, content-free explicit-id plan. Stopped-store `forget apply` owns the
+authoritative writer lease plus a durable sibling recovery fence, creates a
+fsync-verified full backup, commits each id through durable migration-forget,
+and rebuilds the managed generation. Failure restores automatically; process
+death blocks normal writers until recovery resumes. Explicit restore refuses to
+overwrite any durable change made after cleanup and atomically consumes the
+verified sibling snapshot without constructing a third full copy.
 
 For launchd fleet verification, invoke the deployed CLI with each plist's exact
 `ProgramArguments[0]` Node, `[1]` CLI, absolute `--config`/`--env-file`, and

package/dist/background-runtime.d.ts

@@ -28,6 +28,31 @@ export interface ManagedBackgroundRuntimeInput {
     /** Config-selected channel/memory plugin packages that must survive outside the caller's install tree. */
     readonly additionalPackages?: readonly ManagedRuntimeAdditionalPackage[];
 }
+/** Inputs for the read-only fleet attestation of an already materialized runtime. */
+export interface ManagedBackgroundRuntimeAttestationInput {
+    /** CLI from the trusted deploy checkout whose execution closure is expected. */
+    readonly currentCliPath: string;
+    /** CLI path persisted in the managed LaunchAgent. */
+    readonly runtimeCliPath: string;
+    readonly homeDir?: string;
+    readonly packageVersion?: string;
+    readonly nodeAbi?: string;
+    readonly platform?: NodeJS.Platform;
+    readonly arch?: string;
+    readonly packageSource?: string;
+    readonly additionalPackages?: readonly ManagedRuntimeAdditionalPackage[];
+}
+export interface ManagedBackgroundRuntimeAttestation {
+    readonly schema: "mono-agent.managed-runtime-attestation.v1";
+    /** Opaque, path-free identity used only to compare an initial and final probe. */
+    readonly fingerprint: string;
+    /** Safe lifecycle boundary: a managed worker must start after this install. */
+    readonly installedAt: string;
+}
+interface ManagedBackgroundRuntimeAttestationDeps {
+    /** Deterministic race-test seam; production never supplies this hook. */
+    readonly afterInitialCaptures?: () => Promise<void>;
+}
 export interface ManagedRuntimeInstallInput {
     readonly stagingDir: string;
     readonly packageVersion: string;
@@ -59,4 +84,11 @@ export declare function sanitizeManagedBackgroundWorkerEnvironment(env: Record<s
  * version matches.
  */
 export declare function ensureManagedBackgroundRuntime(input: ManagedBackgroundRuntimeInput, deps?: ManagedBackgroundRuntimeDeps): Promise<ManagedBackgroundRuntime>;
+/**
+ * Prove, without installing or repairing anything, that a persisted managed
+ * runtime is the canonical private copy of the exact deploy-source execution
+ * closure (including config-selected plugin roots).
+ */
+export declare function attestManagedBackgroundRuntime(input: ManagedBackgroundRuntimeAttestationInput, deps?: ManagedBackgroundRuntimeAttestationDeps): Promise<ManagedBackgroundRuntimeAttestation>;
+export {};
 //# sourceMappingURL=background-runtime.d.ts.map

package/dist/background-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"background-runtime.d.ts","sourceRoot":"","sources":["../src/background-runtime.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAG3F,eAAO,MAAM,6BAA6B,8BAA8B,CAAC;AAKzE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,gGAAgG;AAChG,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,6BAA6B;IAC5C,yEAAyE;IACzE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,0GAA0G;IAC1G,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,+BAA+B,EAAE,CAAC;CAC1E;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,EAAE,SAAS,+BAA+B,EAAE,CAAC;IACxE,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC;CAC9C;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,8DAA8D;IAC9D,QAAQ,CAAC,yBAAyB,CAAC,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACvE,QAAQ,CAAC,wBAAwB,CAAC,EAAE,sBAAsB,CAAC;CAC5D;AA0GD,wBAAgB,mCAAmC,IAAI,4BAA4B,CASlF;AAED;;;;GAIG;AACH,wBAAgB,0CAA0C,CACxD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,IAAI,CAUN;AAED;;;;;GAKG;AACH,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,6BAA6B,EACpC,IAAI,GAAE,4BAAoE,GACzE,OAAO,CAAC,wBAAwB,CAAC,CAqGnC"}
+{"version":3,"file":"background-runtime.d.ts","sourceRoot":"","sources":["../src/background-runtime.ts"],"names":[],"mappings":"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"}