agentsmesh 0.30.2 → 0.32.0

package/dist/engine.d.ts

@@ -132,10 +132,14 @@ declare function formatDiffSummary(summary: DiffSummary): string;
  */
 
 interface LockSyncReport {
-    /** True when the canonical state matches the lock file and no extend drifted. */
+    /** True when canonical state and checked generated outputs are all in sync. */
     readonly inSync: boolean;
     /** True when a `.lock` file was found at the canonical directory. */
     readonly hasLock: boolean;
+    /** True when canonical files or extends differ from the lock. */
+    readonly canonicalDrift: boolean;
+    /** True when a generated output is modified, removed, or stale. */
+    readonly outputDrift: boolean;
     /** Canonical files whose checksum differs from the lock. */
     readonly modified: readonly string[];
     /** Canonical files present now but not in the lock. */
@@ -149,6 +153,18 @@ interface LockSyncReport {
      * `collaboration.lock_features`. Empty when no `lock_features` are configured.
      */
     readonly lockedViolations: readonly string[];
+    /** Generated outputs whose on-disk hash differs from the lock. */
+    readonly outputsModified: readonly string[];
+    /** Generated outputs recorded in the lock but missing from disk. */
+    readonly outputsRemoved: readonly string[];
+    /** Managed generated outputs present on disk but absent from the lock. */
+    readonly outputsStale: readonly string[];
+    /**
+     * True when output drift was actually verified — requires `rootBase` and a
+     * lock with an `outputs` map. False for old-format locks or when no
+     * `rootBase` was supplied.
+     */
+    readonly outputsChecked: boolean;
 }
 interface CheckLockSyncOptions {
     readonly config: ValidatedConfig;
@@ -156,6 +172,13 @@ interface CheckLockSyncOptions {
     readonly configDir: string;
     /** Directory containing `.agentsmesh/.lock` and canonical files. */
     readonly canonicalDir: string;
+    /**
+     * Project root the generated outputs are relative to. When absent, output
+     * verification is skipped (keeps the programmatic API backward compatible).
+     */
+    readonly rootBase?: string;
+    /** Output-layout scope used when scanning managed locations for stale files. */
+    readonly scope?: TargetLayoutScope;
 }
 
 declare function importFrom(target: string, opts: {