jg-agent-hq 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.5.0
+
+- Add safe publication observations for the host's System view, with separate pending, blocked, failed and uncertain states, timestamps and exact commit identity.
+- Bind publication retries to a receipt UUID and nullable expected commit, including failures that happened before a commit existed. The host continues to own scheduling, Git operations and storage.
+
 ## 0.4.0
 
 - Add closed browser host commands and bounded session/repository/plan read contracts, without exposing private handlers through standalone IPC.

package/api/README.md

@@ -266,6 +266,8 @@ SQLite records an HMAC digest and receipt before invoking the dispatcher. The sa
 
 The dispatcher receives a server-owned `nativeActionId`; use this ID for a native child action, preserving the validated runtime and command. `readBrowserAction(id, operatorId)` returns only that operator's receipt and joins its exact native receipt. Host acknowledgement means the handler completed, not that a native turn completed. An unknown or differently owned ID returns null. Receipts retain metadata rather than message bodies or arbitrary handler output. Subsequent domain reads provide the result. At most 32 host jobs are admitted concurrently. Runtime close rejects new host work and waits for admitted work before closing its worker.
 
+`PublicationStatusSchema` is a browser-safe observation supplied by the host, independent of native execution and quota states. It contains the receipt UUID, state/reason, due/attempt/success timestamps, nullable pending and published commit hashes, and bounded queued/selected file counts. It contains no artifact bodies, paths, credentials or deployment configuration. `publication-retry` requires `publicationId` and `expectedCommit` (null before a commit exists). The host must compare both against its current receipt before acting and reconcile or retry only its recorded verified commit. The public runtime supplies no Git publisher, service installer or publication storage.
+
 Live reads accept `afterRevision`. A matching revision returns `unchanged: true` with an empty data array; retain the displayed window. A changed revision returns the complete bounded window. Revisions belong to one runtime. After reconnect to a new runtime, discard the revision and refresh native history. Token bodies stay in the existing bounded memory window and are never copied into lifecycle or browser-action tables.
 
 `thread-plan` accepts a managed `threadId` and returns its nullable `ActionPlanContextSchema`. The host verifies the thread's registered checkout before exposing it. It is read-only and grants no execution authority.

package/dist/contracts/browser/index.d.ts

@@ -1,4 +1,5 @@
 export { BrowserCommandSchema, BrowserActionSchema, BrowserReceiptSchema } from './types.js';
 export type { IBrowserAction, IBrowserReceipt } from './types.js';
 export { BrowserRepositorySchema, BrowserPlanSummarySchema, BrowserPlanPageSchema, BrowserPlanDetailSchema, BrowserSessionSchema, } from './types.js';
-export { BrowserRepositoryPageSchema, BrowserSystemSchema, BrowserThreadDetailSchema, } from './types.js';
+export { BrowserRepositoryPageSchema, BrowserSystemSchema, BrowserThreadDetailSchema, PublicationStatusSchema, } from './types.js';
+export type { IPublicationStatus } from './types.js';

package/dist/contracts/browser/index.js

@@ -3,4 +3,4 @@ export { BrowserCommandSchema, BrowserActionSchema, BrowserReceiptSchema } from
 // host read models
 export { BrowserRepositorySchema, BrowserPlanSummarySchema, BrowserPlanPageSchema, BrowserPlanDetailSchema, BrowserSessionSchema, } from './types.js';
 // bounded host views
-export { BrowserRepositoryPageSchema, BrowserSystemSchema, BrowserThreadDetailSchema, } from './types.js';
+export { BrowserRepositoryPageSchema, BrowserSystemSchema, BrowserThreadDetailSchema, PublicationStatusSchema, } from './types.js';

package/dist/contracts/browser/types.d.ts

@@ -479,7 +479,8 @@ export declare const BrowserCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     release: z.ZodBoolean;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"publication-retry">;
-    expectedCommit: z.ZodString;
+    publicationId: z.ZodUUID;
+    expectedCommit: z.ZodNullable<z.ZodString>;
 }, z.core.$strict>], "kind">;
 export declare const BrowserActionSchema: z.ZodObject<{
     id: z.ZodUUID;
@@ -964,7 +965,8 @@ export declare const BrowserActionSchema: z.ZodObject<{
         release: z.ZodBoolean;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"publication-retry">;
-        expectedCommit: z.ZodString;
+        publicationId: z.ZodUUID;
+        expectedCommit: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>], "kind">;
 }, z.core.$strict>;
 export type IBrowserAction = z.infer<typeof BrowserActionSchema>;
@@ -2244,6 +2246,43 @@ export declare const BrowserRepositoryPageSchema: z.ZodObject<{
     }, z.core.$strip>>;
     nextCursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+export declare const PublicationStatusSchema: z.ZodObject<{
+    id: z.ZodNullable<z.ZodUUID>;
+    state: z.ZodEnum<{
+        pending: "pending";
+        blocked: "blocked";
+        uncertain: "uncertain";
+        failed: "failed";
+        idle: "idle";
+        publishing: "publishing";
+        published: "published";
+    }>;
+    reason: z.ZodNullable<z.ZodEnum<{
+        owner: "owner";
+        editing: "editing";
+        clean: "clean";
+        enrolled: "enrolled";
+        changed: "changed";
+        git: "git";
+        signing: "signing";
+        verification: "verification";
+        transport: "transport";
+        rejected: "rejected";
+        "remote-changed": "remote-changed";
+        unpublished: "unpublished";
+        staged: "staged";
+        configuration: "configuration";
+        cleanup: "cleanup";
+    }>>;
+    dueAt: z.ZodNumber;
+    attemptedAt: z.ZodNullable<z.ZodNumber>;
+    succeededAt: z.ZodNullable<z.ZodNumber>;
+    commit: z.ZodNullable<z.ZodString>;
+    publishedCommit: z.ZodNullable<z.ZodString>;
+    queuedFiles: z.ZodNumber;
+    selectedFiles: z.ZodNumber;
+}, z.core.$strip>;
+export type IPublicationStatus = z.infer<typeof PublicationStatusSchema>;
 export declare const BrowserSystemSchema: z.ZodObject<{
     runtime: z.ZodObject<{
         runtimeEpoch: z.ZodUUID;
@@ -2272,7 +2311,40 @@ export declare const BrowserSystemSchema: z.ZodObject<{
         }, z.core.$strip>;
     }, z.core.$strip>;
     publication: z.ZodObject<{
-        state: z.ZodLiteral<"unavailable">;
+        id: z.ZodNullable<z.ZodUUID>;
+        state: z.ZodEnum<{
+            pending: "pending";
+            blocked: "blocked";
+            uncertain: "uncertain";
+            failed: "failed";
+            idle: "idle";
+            publishing: "publishing";
+            published: "published";
+        }>;
+        reason: z.ZodNullable<z.ZodEnum<{
+            owner: "owner";
+            editing: "editing";
+            clean: "clean";
+            enrolled: "enrolled";
+            changed: "changed";
+            git: "git";
+            signing: "signing";
+            verification: "verification";
+            transport: "transport";
+            rejected: "rejected";
+            "remote-changed": "remote-changed";
+            unpublished: "unpublished";
+            staged: "staged";
+            configuration: "configuration";
+            cleanup: "cleanup";
+        }>>;
+        dueAt: z.ZodNumber;
+        attemptedAt: z.ZodNullable<z.ZodNumber>;
+        succeededAt: z.ZodNullable<z.ZodNumber>;
+        commit: z.ZodNullable<z.ZodString>;
+        publishedCommit: z.ZodNullable<z.ZodString>;
+        queuedFiles: z.ZodNumber;
+        selectedFiles: z.ZodNumber;
     }, z.core.$strip>;
     resources: z.ZodObject<{
         state: z.ZodLiteral<"unavailable">;

package/dist/contracts/browser/types.js

@@ -24,7 +24,11 @@ export const BrowserCommandSchema = z.discriminatedUnion('kind', [
     }),
     z.strictObject({
         kind: z.literal('publication-retry'),
-        expectedCommit: z.string().regex(/^[a-f0-9]{40}(?:[a-f0-9]{24})?$/),
+        publicationId: z.uuid(),
+        expectedCommit: z
+            .string()
+            .regex(/^[a-f0-9]{40}(?:[a-f0-9]{24})?$/)
+            .nullable(),
     }),
 ]);
 export const BrowserActionSchema = z
@@ -91,9 +95,46 @@ export const BrowserRepositoryPageSchema = z.object({
     data: z.array(BrowserRepositorySchema).max(128),
     nextCursor: z.string().nullable(),
 });
+// publication state is independent of native execution, account quota and repository resources
+export const PublicationStatusSchema = z.object({
+    id: z.uuid().nullable(),
+    state: z.enum(['idle', 'pending', 'publishing', 'published', 'blocked', 'failed', 'uncertain']),
+    reason: z
+        .enum([
+        'clean',
+        'enrolled',
+        'editing',
+        'changed',
+        'git',
+        'signing',
+        'verification',
+        'transport',
+        'rejected',
+        'remote-changed',
+        'unpublished',
+        'staged',
+        'configuration',
+        'owner',
+        'cleanup',
+    ])
+        .nullable(),
+    dueAt: z.number().int().nonnegative(),
+    attemptedAt: z.number().int().nonnegative().nullable(),
+    succeededAt: z.number().int().nonnegative().nullable(),
+    commit: z
+        .string()
+        .regex(/^[a-f0-9]{40}(?:[a-f0-9]{24})?$/)
+        .nullable(),
+    publishedCommit: z
+        .string()
+        .regex(/^[a-f0-9]{40}(?:[a-f0-9]{24})?$/)
+        .nullable(),
+    queuedFiles: z.number().int().min(0).max(1024),
+    selectedFiles: z.number().int().min(0).max(1024),
+});
 export const BrowserSystemSchema = z.object({
     runtime: RuntimeStatusSchema,
-    publication: z.object({ state: z.literal('unavailable') }),
+    publication: PublicationStatusSchema,
     resources: z.object({ state: z.literal('unavailable') }),
     service: z.object({ state: z.literal('unavailable') }),
 });

package/dist/contracts/index.d.ts

@@ -20,4 +20,5 @@ export type { IHandoffCommand, IHandoffPhase, IHandoffSource, IHandoffFindings,
 export { BrowserCommandSchema, BrowserActionSchema, BrowserReceiptSchema, } from './browser/index.js';
 export type { IBrowserAction, IBrowserReceipt } from './browser/index.js';
 export { BrowserRepositorySchema, BrowserPlanSummarySchema, BrowserPlanPageSchema, BrowserPlanDetailSchema, BrowserSessionSchema, } from './browser/index.js';
-export { BrowserRepositoryPageSchema, BrowserSystemSchema, BrowserThreadDetailSchema, } from './browser/index.js';
+export { BrowserRepositoryPageSchema, BrowserSystemSchema, BrowserThreadDetailSchema, PublicationStatusSchema, } from './browser/index.js';
+export type { IPublicationStatus } from './browser/index.js';

package/dist/contracts/index.js

@@ -23,4 +23,4 @@ export { BrowserCommandSchema, BrowserActionSchema, BrowserReceiptSchema, } from
 // host read models
 export { BrowserRepositorySchema, BrowserPlanSummarySchema, BrowserPlanPageSchema, BrowserPlanDetailSchema, BrowserSessionSchema, } from './browser/index.js';
 // bounded host views
-export { BrowserRepositoryPageSchema, BrowserSystemSchema, BrowserThreadDetailSchema, } from './browser/index.js';
+export { BrowserRepositoryPageSchema, BrowserSystemSchema, BrowserThreadDetailSchema, PublicationStatusSchema, } from './browser/index.js';

package/dist/store/types.d.ts

@@ -494,7 +494,8 @@ export declare const StoreCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             release: z.ZodBoolean;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"publication-retry">;
-            expectedCommit: z.ZodString;
+            publicationId: z.ZodUUID;
+            expectedCommit: z.ZodNullable<z.ZodString>;
         }, z.core.$strict>], "kind">;
     }, z.core.$strict>;
     operatorId: z.ZodString;
@@ -2590,7 +2591,8 @@ export declare const StoreRequestSchema: z.ZodObject<{
                 release: z.ZodBoolean;
             }, z.core.$strict>, z.ZodObject<{
                 kind: z.ZodLiteral<"publication-retry">;
-                expectedCommit: z.ZodString;
+                publicationId: z.ZodUUID;
+                expectedCommit: z.ZodNullable<z.ZodString>;
             }, z.core.$strict>], "kind">;
         }, z.core.$strict>;
         operatorId: z.ZodString;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jg-agent-hq",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Native coding-agent workspace primitives.",
   "type": "module",
   "license": "MIT",