@dsh-enhanced/assistant-growth-driver 0.1.65 → 0.1.66

package/lib/scanner-owner-runtime.js

@@ -0,0 +1,99 @@
+import { createHash } from 'node:crypto';
+const digest = (value) => createHash('sha256').update(JSON.stringify(value)).digest('hex');
+/** Availability failures must never be interpreted as obsolete task evidence. */
+export class ScannerOwnerUnavailable extends Error {
+}
+/** Retires only this scanner, preserving its jobs, requests, grants and budgets. */
+export class ScannerOwnerGuard {
+    owner;
+    automationId;
+    scope;
+    delivery;
+    automations;
+    expected;
+    retired = false;
+    // Only the native reconcile transaction may admit a wake-up under an unreadable retirement state.
+    canReconcileScanner = false;
+    constructor(owner, automationId, scope, delivery, automations, expected) {
+        this.owner = owner;
+        this.automationId = automationId;
+        this.scope = scope;
+        this.delivery = delivery;
+        this.automations = automations;
+        this.expected = expected;
+    }
+    check() {
+        this.canReconcileScanner = false;
+        try {
+            if (this.retired)
+                throw new ScannerOwnerUnavailable('scanner permanently retired: owner-revoked');
+            let retirement;
+            try {
+                retirement = this.automations.inspectSystemOwnedRetirement({ owner: this.owner, automationId: this.automationId });
+            }
+            catch (error) {
+                // A read outage must not strand a fresh scanner. Native reconcile checks
+                // retirement before cached receipts and again in its SQLite transaction.
+                // It can establish only this exact scanId, without touching old jobs.
+                this.canReconcileScanner = true;
+                try {
+                    if (this.delivery.inspectOwnerRouteState(this.scope).status === 'revoked')
+                        this.canReconcileScanner = false;
+                }
+                catch { /* The native retirement fence still owns activation admission. */ }
+                throw error;
+            }
+            if (retirement) {
+                this.retired = true;
+                throw new ScannerOwnerUnavailable('scanner permanently retired: owner-revoked');
+            }
+            this.canReconcileScanner = true;
+            const state = this.delivery.inspectOwnerRouteState(this.scope);
+            if (state.status === 'unavailable')
+                throw new ScannerOwnerUnavailable(`scanner owner unavailable: ${state.reason}`);
+            if (state.status === 'active')
+                return state.receipt;
+            this.canReconcileScanner = false;
+            if (this.expected && (state.authorityHash !== this.expected.authorityHash
+                || state.principalRecordId !== this.expected.principalRecordId || state.principalVersion !== this.expected.principalVersion)) {
+                throw new ScannerOwnerUnavailable('scanner owner lineage unavailable');
+            }
+            let current;
+            try {
+                current = this.automations.inspectSystemOwned({ owner: this.owner, automationId: this.automationId });
+            }
+            catch (error) {
+                if (!(error instanceof Error) || error.code !== 'not-found')
+                    throw error;
+            }
+            if (current) {
+                const evidenceDigest = digest({ protocol: 'scanner-owner-revoked/v1', scope: this.scope, state });
+                this.automations.retireSystemOwned({ owner: this.owner, automationId: this.automationId,
+                    operationId: `owner-revoked:${digest([this.owner, this.automationId, current.definitionHash, current.definitionVersion, evidenceDigest])}`,
+                    definitionHash: current.definitionHash, expectedVersion: current.definitionVersion, reason: 'owner-revoked', evidenceDigest });
+            }
+            // An absent definition must stay absent; no replacement grant or row is created.
+            this.retired = true;
+            throw new ScannerOwnerUnavailable('scanner owner explicitly revoked');
+        }
+        catch (error) {
+            if (error instanceof ScannerOwnerUnavailable)
+                throw error;
+            throw new ScannerOwnerUnavailable(`scanner owner inspection or retirement unavailable: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+/** Disposal keeps ownership of in-flight work and has a finite drain deadline. */
+export async function drainScannerFlights(flights) {
+    let timer;
+    try {
+        await Promise.race([Promise.allSettled(flights), new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error('scanner shutdown timed out; in-flight outcomes remain unknown')), 5000);
+            })]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=scanner-owner-runtime.js.map

package/lib/scanner-owner-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner-owner-runtime.js","sourceRoot":"","sources":["../src/scanner-owner-runtime.ts"],"names":[],"mappings":"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"}

package/lib/source-port.d.ts

@@ -9,7 +9,9 @@
  * @dsh-enhanced/plugin-control-plane (an optional peer): every field here is a
  * structural subset, so the driver still builds and loads without that package.
  */
-import type { CreationAcceptanceAuthorityRef, RevisionAcceptanceAuthorityRef, RevisionRegressionAcceptanceAuthorityRef, SourceGrowthRunBinding } from '@dsh-enhanced/assistant-growth-contract';
+import type { OwnerForegroundLearningTask } from '@dsh-enhanced/assistant-delivery';
+import type { WorkItemCreationReadiness } from './work-item-source.js';
+import type { CreationAcceptanceAuthorityRef, RevisionAcceptanceAuthorityRef, RevisionRegressionAcceptanceAuthorityRef, AnySourceGrowthRunBinding } from '@dsh-enhanced/assistant-growth-contract';
 /**
  * Local mirror of the control-plane protected-plugin denylist
  * (PROTECTED_PLUGIN_DENYLIST in plugins/plugin-control-plane/src/source-workspace.ts).
@@ -60,6 +62,23 @@ export interface SourceJobProjection {
     readonly expiresAt: number;
     readonly planId?: string;
     readonly failureCode?: string;
+    /** Present only on a deterministic `source-build-check-failed` job: bounded, sanitized compiler diagnostics. */
+    readonly diagnostics?: SourceBuildDiagnosticsProjection;
+}
+/** Host-sanitized build diagnostics: plugin-relative paths, no host paths or secrets, bounded length. */
+export interface SourceBuildDiagnosticsProjection {
+    readonly protocol: 'dsh-source-build-diagnostics/v1';
+    readonly phase: 'tree' | 'install' | 'check' | 'pack' | 'unknown';
+    readonly exitCode: number;
+    readonly entries: readonly {
+        readonly file: string;
+        readonly line: number;
+        readonly column: number;
+        readonly code: string;
+        readonly message: string;
+    }[];
+    readonly tail: readonly string[];
+    readonly truncated: boolean;
 }
 /** @deprecated Prefer SourceJobProjection; retained for local source-port compatibility. */
 export type GrowthSourceJobProjection = SourceJobProjection;
@@ -96,6 +115,9 @@ export interface GrowthSourceRevisionTarget {
     readonly parentSourceDigest: string;
 }
 export interface GrowthSourcePlanePort {
+    inspectWorkItemCreationReadiness?(input: {
+        owner: OwnerForegroundLearningTask['owner'];
+    }): WorkItemCreationReadiness | undefined;
     /** Optional read-only repository inventory; the Host owns the repository and baseline. */
     inspectSourceTargets?(input: {
         repository: string;
@@ -180,7 +202,7 @@ export interface GrowthSourcePlanePort {
         ttlMs: number;
         owner: GrowthSourceJobOwner;
         /** Host-attested native Usage run; never a model tool parameter. */
-        growthRun?: SourceGrowthRunBinding;
+        growthRun?: AnySourceGrowthRunBinding;
         signal: AbortSignal;
         assertCurrent: () => void;
     }): Promise<SourceJobProjection>;

package/lib/source-port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-port.d.ts","sourceRoot":"","sources":["../src/source-port.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"source-port.d.ts","sourceRoot":"","sources":["../src/source-port.ts"],"names":[],"mappings":"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"}

package/lib/source-port.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-port.js","sourceRoot":"","sources":["../src/source-port.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAwB,IAAI,GAAG,CAAC;IAC3E,oBAAoB,EAAE,2CAA2C;IACjE,cAAc,EAAE,yCAAyC;IACzD,uBAAuB,EAAE,oDAAoD;IAC7E,kBAAkB,EAAE,gBAAgB;IACpC,sBAAsB,EAAE,MAAM;IAC9B,sBAAsB,EAAE,QAAQ;IAChC,oBAAoB,EAAE,WAAW;IACjC,2BAA2B,EAAE,QAAQ;IACrC,8BAA8B,EAAE,QAAQ;IACxC,kBAAkB,EAAE,iCAAiC;IACrD,qBAAqB,EAAE,WAAW;IAClC,qBAAqB,EAAE,cAAc;IACrC,sBAAsB,EAAE,oBAAoB;CAC7C,CAAC,CAAA"}
+{"version":3,"file":"source-port.js","sourceRoot":"","sources":["../src/source-port.ts"],"names":[],"mappings":"AAgBA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAwB,IAAI,GAAG,CAAC;IAC3E,oBAAoB,EAAE,2CAA2C;IACjE,cAAc,EAAE,yCAAyC;IACzD,uBAAuB,EAAE,oDAAoD;IAC7E,kBAAkB,EAAE,gBAAgB;IACpC,sBAAsB,EAAE,MAAM;IAC9B,sBAAsB,EAAE,QAAQ;IAChC,oBAAoB,EAAE,WAAW;IACjC,2BAA2B,EAAE,QAAQ;IACrC,8BAA8B,EAAE,QAAQ;IACxC,kBAAkB,EAAE,iCAAiC;IACrD,qBAAqB,EAAE,WAAW;IAClC,qBAAqB,EAAE,cAAc;IACrC,sBAAsB,EAAE,oBAAoB;CAC7C,CAAC,CAAA"}

package/lib/usage-runtime.d.ts

@@ -1,12 +1,13 @@
 import type { AssistantAutomationsService } from '@dsh-enhanced/assistant-automations';
 import type { AssistantEvaluationService } from '@dsh-enhanced/assistant-evaluation';
 import type { AssistantDeliveryService, OwnerForegroundLearningTask } from '@dsh-enhanced/assistant-delivery';
-import { type CreationAcceptanceAuthorityRef, type RevisionAcceptanceAuthorityRef, type RevisionRegressionAcceptanceAuthorityRef, type SourceGrowthRunBinding, type SourceGrowthRunRequest } from '@dsh-enhanced/assistant-growth-contract';
+import { type CreationAcceptanceAuthorityRef, type RevisionAcceptanceAuthorityRef, type RevisionRegressionAcceptanceAuthorityRef, type AnySourceGrowthRunBinding, type WorkItemSourceGrowthRunBinding, type SourceGrowthRunBinding, type SourceGrowthRunRequest } from '@dsh-enhanced/assistant-growth-contract';
 import type { NormalizedGrowthDriverConfig } from './config.js';
 import { type UsageModel } from './usage-store.js';
-type Evaluation = Pick<AssistantEvaluationService, 'canonicalHostScope' | 'listTrustedTaskLearningProjections' | 'withTrustedCanonicalTaskWriterFence' | 'onTrustedTaskChange'>;
-type Delivery = Pick<AssistantDeliveryService, 'validateOwnerRoute' | 'inspectOwnerForegroundLearningTask'>;
-type Automations = Pick<AssistantAutomationsService, 'registerHostExecutor' | 'reconcileSystem' | 'inspectSystemOwnedActivation' | 'inspectSystemOwned'>;
+import { type WorkItemCreationReadiness, type WorkItemUsageSource } from './work-item-source.js';
+type Evaluation = Pick<AssistantEvaluationService, 'canonicalHostScope' | 'listTrustedTaskLearningProjections' | 'withTrustedCanonicalTaskWriterFence' | 'onTrustedTaskChange'> & Partial<Pick<AssistantEvaluationService, 'getTrustedWorkItemLearningProjection'>>;
+type Delivery = Pick<AssistantDeliveryService, 'validateOwnerRoute' | 'inspectOwnerRouteState' | 'inspectOwnerForegroundLearningTask'> & Partial<Pick<AssistantDeliveryService, 'inspectOwnerWorkItemEngineeringContext' | 'readOwnerWorkItemEngineeringContext' | 'withOwnerWorkItemEngineeringContextFence'>>;
+type Automations = Pick<AssistantAutomationsService, 'inspectSystemOwnedRetirement' | 'retireSystemOwned' | 'onSchedulerWake' | 'registerHostExecutor' | 'reconcileSystem' | 'inspectSystemOwnedActivation' | 'inspectSystemOwned'>;
 export interface UsageReviewInput {
     id: string;
     intentDigest: string;
@@ -19,6 +20,13 @@ export interface UsageReviewInput {
     assertCurrent(): void;
     bindSourceRun(input: Pick<SourceGrowthRunBinding, 'model' | 'sessionId' | 'toolContractDigest' | 'executionContractDigest' | 'createdAt' | 'generationDeadlineAt' | 'creationAcceptance' | 'revisionAcceptance' | 'revisionRegressionAcceptance'>): SourceGrowthRunBinding;
 }
+export interface WorkItemUsageReviewInput extends Omit<UsageReviewInput, 'source' | 'bindSourceRun'> {
+    sourceKind: 'work-item';
+    assertFirstModelAdmission(): void;
+    source: WorkItemUsageSource;
+    bindSourceRun(input: Parameters<UsageReviewInput['bindSourceRun']>[0]): WorkItemSourceGrowthRunBinding;
+}
+export type AnyUsageReviewInput = UsageReviewInput | WorkItemUsageReviewInput;
 export type UsageReviewResult = 'reviewed' | 'failed' | 'unknown';
 /** Durable task-driven reviews; only native Automations owns timers/claims. */
 export declare class UsageLearningRuntime {
@@ -32,6 +40,9 @@ export declare class UsageLearningRuntime {
     private readonly flights;
     private unregister;
     private unsubscribe;
+    private readonly ownerGuard;
+    private unsubscribeWake;
+    private initialized;
     private active;
     private scanning;
     private lastError;
@@ -41,6 +52,11 @@ export declare class UsageLearningRuntime {
         evaluation: Evaluation;
         delivery: Delivery;
         automations: Automations;
+        inspectWorkItemToolPreauthorization?(): boolean;
+        reviewWorkItem?(input: WorkItemUsageReviewInput): Promise<UsageReviewResult>;
+        inspectWorkItemCreationReadiness?(input: {
+            owner: WorkItemUsageSource['task']['owner'];
+        }): WorkItemCreationReadiness | undefined;
         review(input: UsageReviewInput): Promise<UsageReviewResult>;
         inspectCreationAcceptanceAuthority?(): CreationAcceptanceAuthorityRef | undefined;
         inspectRevisionAcceptanceAuthority?(): RevisionAcceptanceAuthorityRef | undefined;
@@ -54,10 +70,25 @@ export declare class UsageLearningRuntime {
         counts: Readonly<Record<string, number>>;
     };
     start(): void;
+    private initializeScanner;
     close(): Promise<void>;
     private owner;
     private source;
     inspectSourceGrowthRun: (request: SourceGrowthRunRequest) => SourceGrowthRunBinding | undefined;
+    private workItemScope;
+    private assertWorkItemReadiness;
+    private currentWorkItem;
+    private expectation;
+    private locatorFor;
+    private withWorkItemSource;
+    private readWorkItem;
+    private scanWorkItems;
+    inspectAnySourceGrowthRun: (request: SourceGrowthRunRequest) => AnySourceGrowthRunBinding | undefined;
+    withWorkItemRunFence: <T>(input: SourceGrowthRunRequest & {
+        expectedGrowthRunDigest: string;
+    }, callback: (binding: Readonly<WorkItemSourceGrowthRunBinding>) => T) => T;
+    private assertWorkItemBinding;
+    private executeWorkItem;
     /** Synchronous nudge, bounded to 1000 heads. Native scan resumes the cursor. */
     scan: () => void;
     private definition;

package/lib/usage-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage-runtime.d.ts","sourceRoot":"","sources":["../src/usage-runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"usage-runtime.d.ts","sourceRoot":"","sources":["../src/usage-runtime.ts"],"names":[],"mappings":"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"}