@principles/core 1.84.0 → 1.86.0

package/dist/runtime-v2/internalization/artificer-runner.d.ts

@@ -1,10 +1,49 @@
-import type { RuntimeStateManager } from '../store/runtime-state-manager.js';
-import type { PDRuntimeAdapter } from '../runtime-protocol.js';
-import type { StoreEventEmitter } from '../store/event-emitter.js';
+/**
+ * ArtificerRunner — Implementation plan generator for the Internalization Engine (PRI-111).
+ *
+ * Migrated to extend BasePeerRunner (PRI-302). The shared lease → buildContext →
+ * invoke → poll → fetch → validate → succeed/fail pipeline is now in the base
+ * class. This file only contains Artificer-specific logic.
+ *
+ * Key constraints (ADR-0003):
+ *   - Uses PDRuntimeAdapter for all LLM execution (no direct SDK calls)
+ *   - Does NOT directly invoke Evaluator/RolloutReviewer (host layer enqueues)
+ *   - No plugin-layer imports (core is infrastructure-agnostic)
+ *   - Uses RuntimeStateManager for all state operations
+ *
+ * Trust boundary (Artificer is activation-capable, higher risk than upstream runners):
+ *   - LLM output enters as `unknown`; only after validateOutput + lineage check
+ *     can it be treated as ArtificerOutputV1
+ *   - sourceScribeArtifactId lineage consistency enforced in succeedTask (ERR-004)
+ *   - Invalid activation/action/channel cannot succeed commit
+ *   - Artifact write failure → retryOrFail, never silent
+ *
+ * Pipeline:
+ *   1. acquireLease — isolated try/catch, lease_conflict is non-mutating
+ *   2. resolve Scribe dependency from dependencyTaskIds
+ *   3. fetch Scribe artifact via PIArtifactStore
+ *   4. startRun with outputSchemaRef: 'artificer-output-v1'
+ *   5. pollUntilTerminal (inherited)
+ *   6. fetchOutput → validate as unknown → cast to ArtificerOutputV1
+ *   7. checkLineageIntegrity (sourceScribeArtifactId consistency, ERR-008)
+ *   8. updateRunOutput → persist serialized output
+ *   9. write PIArtifact → markTaskSucceeded with artificer:// resultRef
+ *
+ * @see docs/adr/0003-peer-agent-state-machine-orchestration.md
+ * @see BasePeerRunner in runner/base-peer-runner.ts
+ */
+import type { RunHandle } from '../runtime-protocol.js';
 import type { ArtificerOutputV1, ArtificerValidator } from './artificer-output.js';
-import type { PIArtifactStore } from './pi-artifact.js';
+import type { TaskRecord } from '../task-status.js';
 import { type PDErrorCategory } from '../error-categories.js';
-import { RunnerPhase } from '../runner/runner-phase.js';
+import { BasePeerRunner } from '../runner/base-peer-runner.js';
+import type { PeerRunnerOptions, PeerRunnerDeps, PeerRunnerResult, PeerRunnerValidationResult } from '../runner/peer-runner-types.js';
+/** Context built by ArtificerRunner.buildContext() and consumed by invokeRuntime(). */
+interface ArtificerContext {
+    readonly contextHash: string;
+    readonly scribeArtifact: string | null;
+    readonly sourceScribeArtifactId: string | null;
+}
 export type ArtificerRunnerResultStatus = 'succeeded' | 'failed' | 'retried';
 export interface ArtificerRunnerResult {
     readonly status: ArtificerRunnerResultStatus;
@@ -36,42 +75,24 @@ export interface ResolvedArtificerRunnerOptions {
 }
 declare const DEFAULT_ARTIFICER_RUNNER_OPTIONS: Readonly<Omit<ResolvedArtificerRunnerOptions, 'owner' | 'runtimeKind'>>;
 export declare function resolveArtificerRunnerOptions(options: ArtificerRunnerOptions): ResolvedArtificerRunnerOptions;
-export interface ArtificerRunnerDeps {
-    readonly stateManager: RuntimeStateManager;
-    readonly runtimeAdapter: PDRuntimeAdapter;
-    readonly eventEmitter: StoreEventEmitter;
+export interface ArtificerRunnerDeps extends PeerRunnerDeps {
     readonly validator: ArtificerValidator;
-    readonly artifactStore: PIArtifactStore;
 }
-export declare class ArtificerRunner {
-    private phase;
-    private readonly resolvedOptions;
-    private readonly stateManager;
-    private readonly runtimeAdapter;
-    private readonly eventEmitter;
+export declare class ArtificerRunner extends BasePeerRunner<ArtificerContext, ArtificerOutputV1> {
     private readonly validator;
-    private readonly artifactStore;
-    constructor(deps: ArtificerRunnerDeps, options: ArtificerRunnerOptions);
-    get currentPhase(): RunnerPhase;
-    private emitArtificerEvent;
-    run(taskId: string): Promise<ArtificerRunnerResult>;
-    private buildContext;
-    private static hashContextRefs;
-    private resolveStoreRunId;
-    private invokeRuntime;
-    private pollUntilTerminal;
-    private fetchAndParseOutput;
-    private succeedTask;
-    private handleRuntimeFailure;
-    private handleValidationError;
-    private handleLeaseOrPhaseError;
-    private handlePostLeaseError;
-    private retryOrFail;
-    private readonly PERMANENT_ERROR_CATEGORIES;
-    private isPermanentError;
-    private classifyError;
-    private mapRunStatusToErrorCategory;
-    private sleep;
+    constructor(deps: ArtificerRunnerDeps, options: PeerRunnerOptions);
+    get permanentErrorCategories(): ReadonlySet<PDErrorCategory>;
+    buildContext(taskId: string): Promise<ArtificerContext>;
+    invokeRuntime(taskId: string, context: ArtificerContext): Promise<RunHandle>;
+    validateOutput(output: unknown, taskId: string, context: ArtificerContext): Promise<PeerRunnerValidationResult>;
+    succeedTask(taskId: string, runId: string, output: ArtificerOutputV1, task: TaskRecord, contextHash: string, context: ArtificerContext): Promise<PeerRunnerResult<ArtificerOutputV1>>;
+    /**
+     * Re-inject taskId if stripped by stripLineageFields (PRI-272 / ERR-008).
+     * Only fill when absent via Object.hasOwn — present-but-falsy values
+     * must reach validation and fail loud (Runtime Contract Rule 3).
+     */
+    protected postFetchTransform(taskId: string, untrustedOutput: unknown): void;
+    protected emitSuccessTelemetry(taskId: string, output: ArtificerOutputV1): void;
 }
 export { DEFAULT_ARTIFICER_RUNNER_OPTIONS };
 //# sourceMappingURL=artificer-runner.d.ts.map

package/dist/runtime-v2/internalization/artificer-runner.d.ts.map

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