pulseed 0.6.2 → 0.6.4

package/dist/adapters/agents/claude-api.d.ts

@@ -1,10 +1,10 @@
 import type { IAdapter, AgentTask, AgentResult } from "../../orchestrator/execution/adapter-layer.js";
 import type { ILLMClient } from "../../base/llm/llm-client.js";
 export declare class ClaudeAPIAdapter implements IAdapter {
-    readonly adapterType = "claude_api";
+    readonly adapterType: string;
     readonly capabilities: readonly ["text_generation", "analysis", "planning"];
     private readonly llmClient;
-    constructor(llmClient: ILLMClient);
+    constructor(llmClient: ILLMClient, adapterType?: string);
     execute(task: AgentTask): Promise<AgentResult>;
 }
 //# sourceMappingURL=claude-api.d.ts.map

package/dist/adapters/agents/claude-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-api.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/claude-api.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AACtG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,QAAQ,CAAC,WAAW,gBAAgB;IACpC,QAAQ,CAAC,YAAY,uDAAwD;IAE7E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;gBAE3B,SAAS,EAAE,UAAU;IAI3B,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAsDrD"}
+{"version":3,"file":"claude-api.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/claude-api.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AACtG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,qBAAa,gBAAiB,YAAW,QAAQ;IAKZ,QAAQ,CAAC,WAAW;IAJvD,QAAQ,CAAC,YAAY,uDAAwD;IAE7E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;gBAE3B,SAAS,EAAE,UAAU,EAAW,WAAW,SAAe;IAIhE,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAsDrD"}

package/dist/adapters/agents/claude-api.js

@@ -4,10 +4,11 @@
 // Intended for tasks where a single LLM call is sufficient.
 // Timeout is handled via Promise.race().
 export class ClaudeAPIAdapter {
-    adapterType = "claude_api";
+    adapterType;
     capabilities = ["text_generation", "analysis", "planning"];
     llmClient;
-    constructor(llmClient) {
+    constructor(llmClient, adapterType = "claude_api") {
+        this.adapterType = adapterType;
         this.llmClient = llmClient;
     }
     async execute(task) {

package/dist/adapters/agents/claude-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude-api.js","sourceRoot":"","sources":["../../../src/adapters/agents/claude-api.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,EAAE;AACF,+DAA+D;AAC/D,4DAA4D;AAC5D,yCAAyC;AAKzC,MAAM,OAAO,gBAAgB;IAClB,WAAW,GAAG,YAAY,CAAC;IAC3B,YAAY,GAAG,CAAC,iBAAiB,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC;IAE5D,SAAS,CAAa;IAEvC,YAAY,SAAqB;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAe;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,kEAAkE;QAClE,IAAI,aAAwD,CAAC;QAC7D,MAAM,cAAc,GAAyB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACnE,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,OAAO,CAAC;oBACN,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,mBAAmB,IAAI,CAAC,UAAU,IAAI;oBAC7C,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,cAAc,EAAE,SAAS;iBAC1B,CAAC,CAAC;YACL,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,uBAAuB;QACvB,MAAM,UAAU,GAAyB,CAAC,KAAK,IAAI,EAAE;YACnD,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACvF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;oBAC5C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;iBACvC,EAAE,UAAU,CAAC,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,QAAQ,CAAC,OAAO;oBACxB,KAAK,EAAE,IAAI;oBACX,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,cAAc,EAAE,WAAoB;iBACrC,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;oBACvD,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,cAAc,EAAE,OAAgB;iBACjC,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;QAEhE,iDAAiD;QACjD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,YAAY,CAAC,aAAa,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
+{"version":3,"file":"claude-api.js","sourceRoot":"","sources":["../../../src/adapters/agents/claude-api.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,EAAE;AACF,+DAA+D;AAC/D,4DAA4D;AAC5D,yCAAyC;AAKzC,MAAM,OAAO,gBAAgB;IAKiB;IAJnC,YAAY,GAAG,CAAC,iBAAiB,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC;IAE5D,SAAS,CAAa;IAEvC,YAAY,SAAqB,EAAW,cAAc,YAAY;QAA1B,gBAAW,GAAX,WAAW,CAAe;QACpE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAe;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,kEAAkE;QAClE,IAAI,aAAwD,CAAC;QAC7D,MAAM,cAAc,GAAyB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACnE,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,OAAO,CAAC;oBACN,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,mBAAmB,IAAI,CAAC,UAAU,IAAI;oBAC7C,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,cAAc,EAAE,SAAS;iBAC1B,CAAC,CAAC;YACL,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,uBAAuB;QACvB,MAAM,UAAU,GAAyB,CAAC,KAAK,IAAI,EAAE;YACnD,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACvF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;oBAC5C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;iBACvC,EAAE,UAAU,CAAC,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,QAAQ,CAAC,OAAO;oBACxB,KAAK,EAAE,IAAI;oBACX,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,cAAc,EAAE,WAAoB;iBACrC,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;oBACvD,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,cAAc,EAAE,OAAgB;iBACjC,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;QAEhE,iDAAiD;QACjD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,YAAY,CAAC,aAAa,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/adapters/agents/openai-codex.d.ts

@@ -12,6 +12,8 @@ export interface OpenAICodexCLIAdapterConfig {
     sandboxPolicy?: string | null;
     /** If set, pass -m <model> to the CLI. */
     model?: string;
+    /** If set, pass Codex model_reasoning_effort through -c. */
+    reasoningEffort?: string;
     /** Repository path passed to Codex for workspace-aware execution. Default: "." */
     repoPath?: string;
     /** Pass --skip-git-repo-check. Default: true for daemon/test workspaces. */
@@ -25,6 +27,7 @@ export declare class OpenAICodexCLIAdapter implements IAdapter {
     private readonly cliPath;
     private readonly sandboxPolicy;
     private readonly model;
+    private readonly reasoningEffort;
     private readonly repoPath;
     private readonly skipGitRepoCheck;
     private readonly terminalBackend?;

package/dist/adapters/agents/openai-codex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-codex.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/openai-codex.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AACtG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAEpG,MAAM,WAAW,2BAA2B;IAC1C,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,8EAA8E;IAC9E,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED,qBAAa,qBAAsB,YAAW,QAAQ;IACpD,QAAQ,CAAC,WAAW,sBAAsB;IAC1C,QAAQ,CAAC,YAAY,yEAA0E;IAE/F,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAwB;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAErB,MAAM,GAAE,2BAAgC,EAAE,MAAM,CAAC,EAAE,MAAM;IAW/D,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CA6DrD"}
+{"version":3,"file":"openai-codex.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/openai-codex.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AACtG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAEpG,MAAM,WAAW,2BAA2B;IAC1C,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,8EAA8E;IAC9E,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED,qBAAa,qBAAsB,YAAW,QAAQ;IACpD,QAAQ,CAAC,WAAW,sBAAsB;IAC1C,QAAQ,CAAC,YAAY,yEAA0E;IAE/F,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAwB;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAErB,MAAM,GAAE,2BAAgC,EAAE,MAAM,CAAC,EAAE,MAAM;IAY/D,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAiErD"}

package/dist/adapters/agents/openai-codex.js

@@ -22,6 +22,7 @@ export class OpenAICodexCLIAdapter {
     cliPath;
     sandboxPolicy;
     model;
+    reasoningEffort;
     repoPath;
     skipGitRepoCheck;
     terminalBackend;
@@ -31,6 +32,7 @@ export class OpenAICodexCLIAdapter {
         this.sandboxPolicy =
             config.sandboxPolicy !== undefined ? config.sandboxPolicy : "workspace-write";
         this.model = config.model;
+        this.reasoningEffort = config.reasoningEffort;
         this.repoPath = config.repoPath?.trim() || ".";
         this.skipGitRepoCheck = config.skipGitRepoCheck ?? true;
         this.terminalBackend = config.terminalBackend;
@@ -47,6 +49,9 @@ export class OpenAICodexCLIAdapter {
         if (this.model) {
             spawnArgs.push("-m", this.model);
         }
+        if (this.reasoningEffort) {
+            spawnArgs.push("-c", `model_reasoning_effort="${this.reasoningEffort}"`);
+        }
         if (this.skipGitRepoCheck) {
             spawnArgs.push("--skip-git-repo-check");
         }

package/dist/adapters/agents/openai-codex.js.map

@@ -1 +1 @@
-{"version":3,"file":"openai-codex.js","sourceRoot":"","sources":["../../../src/adapters/agents/openai-codex.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"openai-codex.js","sourceRoot":"","sources":["../../../src/adapters/agents/openai-codex.ts"],"names":[],"mappings":"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"}

package/dist/adapters/datasources/artifact-metric-datasource.d.ts

@@ -1,18 +1,31 @@
 import type { DataSourceConfig, DataSourceQuery, DataSourceResult, DataSourceType } from "../../base/types/data-source.js";
 import type { IDataSourceAdapter } from "../../platform/observation/data-source-adapter.js";
+type Aggregation = "max" | "min" | "count" | "file_count";
+type FreshnessScope = "none" | "goal" | "task" | "run";
+export interface ArtifactMetricFreshnessScope {
+    freshAfterTime: string;
+    freshnessScope: Exclude<FreshnessScope, "none">;
+    freshnessScopeId: string;
+}
 export declare function createWorkspaceArtifactMetricDataSource(workspacePath?: string): ArtifactMetricDataSourceAdapter;
+export declare function createGoalWorkspaceArtifactMetricDataSource(goalId: string, workspacePath: string, dimensionMetrics: Record<string, string[]>, dimensionAggregations?: Record<string, Aggregation>, freshnessScope?: ArtifactMetricFreshnessScope): ArtifactMetricDataSourceAdapter;
 export declare class ArtifactMetricDataSourceAdapter implements IDataSourceAdapter {
     readonly sourceId: string;
     readonly sourceType: DataSourceType;
     readonly config: DataSourceConfig;
+    private observationPassCache;
     constructor(config: DataSourceConfig);
     connect(): Promise<void>;
     disconnect(): Promise<void>;
     healthCheck(): Promise<boolean>;
+    beginObservationPass(): void;
+    endObservationPass(): void;
     getSupportedDimensions(): string[];
     supportsDimension(dimensionName: string): boolean;
     query(params: DataSourceQuery): Promise<DataSourceResult>;
     private workspaceRoot;
     private scanOptions;
+    private discoverMetricCandidatesForPass;
 }
+export {};
 //# sourceMappingURL=artifact-metric-datasource.d.ts.map

package/dist/adapters/datasources/artifact-metric-datasource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifact-metric-datasource.d.ts","sourceRoot":"","sources":["../../../src/adapters/datasources/artifact-metric-datasource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACf,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAuE5F,wBAAgB,uCAAuC,CAAC,aAAa,SAAgB,GAAG,+BAA+B,CAStH;AAED,qBAAa,+BAAgC,YAAW,kBAAkB;IACxE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAqB;IACxD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;gBAEtB,MAAM,EAAE,gBAAgB;IAK9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC,sBAAsB,IAAI,MAAM,EAAE;IAWlC,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;IAI3C,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyE/D,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,WAAW;CAoBpB"}
+{"version":3,"file":"artifact-metric-datasource.d.ts","sourceRoot":"","sources":["../../../src/adapters/datasources/artifact-metric-datasource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACf,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAE5F,KAAK,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,YAAY,CAAC;AAG1D,KAAK,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAGvD,MAAM,WAAW,4BAA4B;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAChD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAgGD,wBAAgB,uCAAuC,CAAC,aAAa,SAAgB,GAAG,+BAA+B,CAStH;AAED,wBAAgB,2CAA2C,CACzD,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC1C,qBAAqB,GAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAM,EACvD,cAAc,CAAC,EAAE,4BAA4B,GAC5C,+BAA+B,CAwBjC;AAED,qBAAa,+BAAgC,YAAW,kBAAkB;IACxE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAqB;IACxD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,OAAO,CAAC,oBAAoB,CAAqD;gBAErE,MAAM,EAAE,gBAAgB;IAK9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC,oBAAoB,IAAI,IAAI;IAI5B,kBAAkB,IAAI,IAAI;IAI1B,sBAAsB,IAAI,MAAM,EAAE;IAWlC,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;IAI3C,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+G/D,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,WAAW;YA2BL,+BAA+B;CAU9C"}

package/dist/adapters/datasources/artifact-metric-datasource.js

@@ -2,7 +2,7 @@ import * as fs from "node:fs/promises";
 import * as path from "node:path";
 const BUILTIN_SOURCE_ID = "ds_builtin_workspace_artifacts";
 const DEFAULT_METRIC_FILE_NAMES = ["metrics.json", "result.json"];
-const DEFAULT_ARTIFACT_ROOTS = ["artifacts", "runs", "reports", "outputs", "results", "logs"];
+const DEFAULT_ARTIFACT_ROOTS = ["artifacts", "experiments", "runs", "reports", "outputs", "results", "logs"];
 const DEFAULT_EXCLUDE_DIRS = new Set([
     ".cache",
     ".git",
@@ -18,6 +18,7 @@ const DEFAULT_EXCLUDE_PATHS = new Set(["data/raw"]);
 const DEFAULT_MAX_METRIC_FILES = 5_000;
 const DEFAULT_MAX_ARTIFACT_FILES = 100_000;
 const DEFAULT_MAX_CANDIDATES = 200;
+const DEFAULT_GOAL_SCOPED_STALE_AFTER_MS = 24 * 60 * 60 * 1000;
 const MAX_RAW_CANDIDATES = 25;
 export function createWorkspaceArtifactMetricDataSource(workspacePath = process.cwd()) {
     return new ArtifactMetricDataSourceAdapter({
@@ -29,10 +30,36 @@ export function createWorkspaceArtifactMetricDataSource(workspacePath = process.
         created_at: new Date().toISOString(),
     });
 }
+export function createGoalWorkspaceArtifactMetricDataSource(goalId, workspacePath, dimensionMetrics, dimensionAggregations = {}, freshnessScope) {
+    return new ArtifactMetricDataSourceAdapter({
+        id: `${BUILTIN_SOURCE_ID}:goal:${goalId}`,
+        name: "builtin:goal workspace artifact metrics",
+        type: "artifact_metric",
+        connection: {
+            path: workspacePath,
+            dimension_metrics: dimensionMetrics,
+            dimension_aggregations: dimensionAggregations,
+            require_metric_match: true,
+            stale_after_ms: DEFAULT_GOAL_SCOPED_STALE_AFTER_MS,
+            ...(freshnessScope
+                ? {
+                    fresh_after_time: freshnessScope.freshAfterTime,
+                    freshness_scope: freshnessScope.freshnessScope,
+                    freshness_scope_id: freshnessScope.freshnessScopeId,
+                }
+                : {}),
+            current_progress_policy: "completed_fresh_only",
+        },
+        enabled: true,
+        created_at: new Date().toISOString(),
+        scope_goal_id: goalId,
+    });
+}
 export class ArtifactMetricDataSourceAdapter {
     sourceId;
     sourceType = "artifact_metric";
     config;
+    observationPassCache = null;
     constructor(config) {
         this.config = config;
         this.sourceId = config.id;
@@ -52,6 +79,12 @@ export class ArtifactMetricDataSourceAdapter {
             return false;
         }
     }
+    beginObservationPass() {
+        this.observationPassCache = new Map();
+    }
+    endObservationPass() {
+        this.observationPassCache = null;
+    }
     getSupportedDimensions() {
         const dimensions = new Set([
             ...Object.keys(this.config.dimension_mapping ?? {}),
@@ -80,17 +113,19 @@ export class ArtifactMetricDataSourceAdapter {
                     aggregation,
                     file_count: count,
                     discovery: discoveryRaw(options),
+                    freshness: freshnessRaw(options, null, [], "file_count"),
                 },
                 timestamp,
                 source_id: this.sourceId,
             };
         }
         const keys = resolveMetricKeys(params.dimension_name, expression, this.config);
-        const candidates = await discoverMetricCandidates(root, options, keys);
-        const observations = await readMetricObservations(candidates);
+        const snapshot = await this.discoverMetricCandidatesForPass(root, options);
+        const candidates = selectCandidatesForKeys(snapshot.candidates, keys, options);
+        const observations = await readMetricObservations(candidates, options);
         const evidenceCandidates = buildEvidenceCandidates(observations, keys, aggregation === "min" ? "min" : "max");
         if (aggregation === "count") {
-            const matched = observations.filter((observation) => hasAnyMetric(observation, keys));
+            const matched = observations.filter((observation) => observation.eligibleForCurrentProgress && hasAnyMetric(observation, keys));
             return {
                 value: matched.length,
                 raw: {
@@ -100,10 +135,12 @@ export class ArtifactMetricDataSourceAdapter {
                     matched_metric_files: matched.length,
                     metric_keys: keys,
                     discovery: discoveryRaw(options),
+                    freshness: freshnessRaw(options, null, observations, matched.length > 0 ? "eligible" : "missing"),
                     candidates: rawCandidates(candidates),
                     evidence_candidates: evidenceCandidates,
                     conflicts: detectMetricConflicts(params.dimension_name, observations, keys),
                     stale_candidates: staleRaw(observations),
+                    ineligible_candidates: ineligibleRaw(observations),
                     strategic_correctness: "not_evaluated",
                 },
                 timestamp,
@@ -111,6 +148,38 @@ export class ArtifactMetricDataSourceAdapter {
             };
         }
         const match = selectMetric(observations, keys, aggregation);
+        if (this.config.connection.require_metric_match && match === null) {
+            if (hasCurrentScopeStaleMetricMatch(observations, keys, options)) {
+                return {
+                    value: 0,
+                    raw: {
+                        root,
+                        aggregation,
+                        inspected_metric_files: candidates.length,
+                        metric_keys: keys,
+                        selected_path: null,
+                        selected_key: null,
+                        selected_value: 0,
+                        selected: null,
+                        discovery: discoveryRaw(options),
+                        freshness: freshnessRaw(options, null, observations, "ineligible_artifact_metrics_only"),
+                        candidates: rawCandidates(candidates),
+                        evidence_candidates: evidenceCandidates,
+                        conflicts: detectMetricConflicts(params.dimension_name, observations, keys),
+                        stale_candidates: staleRaw(observations),
+                        ineligible_candidates: ineligibleRaw(observations),
+                        strategic_correctness: "not_evaluated",
+                    },
+                    timestamp,
+                    source_id: this.sourceId,
+                    metadata: {
+                        confidence: 0.35,
+                        confidence_reason: "Only stale or pre-scope artifact metrics matched the current progress datasource query.",
+                    },
+                };
+            }
+            throw new Error(`No artifact metric found for dimension "${params.dimension_name}" using keys [${keys.join(", ")}]`);
+        }
         return {
             value: match?.value ?? 0,
             raw: {
@@ -123,10 +192,12 @@ export class ArtifactMetricDataSourceAdapter {
                 selected_value: match?.value ?? 0,
                 selected: match,
                 discovery: discoveryRaw(options),
+                freshness: freshnessRaw(options, match, observations, match ? "eligible" : "missing"),
                 candidates: rawCandidates(candidates),
                 evidence_candidates: evidenceCandidates,
                 conflicts: detectMetricConflicts(params.dimension_name, observations, keys),
                 stale_candidates: staleRaw(observations),
+                ineligible_candidates: ineligibleRaw(observations),
                 strategic_correctness: "not_evaluated",
             },
             timestamp,
@@ -155,8 +226,24 @@ export class ArtifactMetricDataSourceAdapter {
             maxArtifactFiles: this.config.connection.max_artifact_files ?? DEFAULT_MAX_ARTIFACT_FILES,
             maxCandidates: this.config.connection.max_candidates ?? DEFAULT_MAX_CANDIDATES,
             staleAfterMs: this.config.connection.stale_after_ms,
+            currentProgressPolicy: this.config.connection.current_progress_policy ?? "legacy",
+            freshAfterTime: this.config.connection.fresh_after_time,
+            freshAfterMs: parseIsoMs(this.config.connection.fresh_after_time),
+            freshnessScope: this.config.connection.freshness_scope ?? "none",
+            freshnessScopeId: this.config.connection.freshness_scope_id,
+            nowMs: Date.now(),
         };
     }
+    async discoverMetricCandidatesForPass(root, options) {
+        const cacheKey = scanCacheKey(root, options);
+        const cached = this.observationPassCache?.get(cacheKey);
+        if (cached)
+            return cached;
+        const candidates = await discoverMetricCandidates(root, options, []);
+        const snapshot = { candidates };
+        this.observationPassCache?.set(cacheKey, snapshot);
+        return snapshot;
+    }
 }
 async function discoverMetricCandidates(root, options, keys) {
     const discovered = new Map();
@@ -185,9 +272,46 @@ async function discoverMetricCandidates(root, options, keys) {
         });
     }
     return Array.from(discovered.values())
+        .sort(compareCandidates)
+        .slice(0, keys.length === 0 ? options.maxMetricFiles : options.maxCandidates);
+}
+function selectCandidatesForKeys(candidates, keys, options) {
+    return candidates
+        .map((candidate) => applyMetricKeyScore(candidate, keys))
         .sort(compareCandidates)
         .slice(0, options.maxCandidates);
 }
+function applyMetricKeyScore(candidate, keys) {
+    let score = candidate.candidateScore;
+    const reasons = [...candidate.reasons];
+    for (const key of keys) {
+        if (candidate.relativePath.toLowerCase().includes(key.toLowerCase())) {
+            score += 8;
+            reasons.push(`path metric hint: ${key}`);
+            break;
+        }
+    }
+    return { ...candidate, candidateScore: score, reasons };
+}
+function scanCacheKey(root, options) {
+    return JSON.stringify({
+        root,
+        metricFileNames: [...options.metricFileNames].sort(),
+        artifactRoots: options.artifactRoots,
+        includePaths: options.includePaths,
+        parserHints: [...options.parserHints].sort(),
+        excludeDirs: [...options.excludeDirs].sort(),
+        excludePaths: [...options.excludePaths].sort(),
+        maxMetricFiles: options.maxMetricFiles,
+        maxArtifactFiles: options.maxArtifactFiles,
+        maxCandidates: options.maxCandidates,
+        staleAfterMs: options.staleAfterMs,
+        freshAfterTime: options.freshAfterTime,
+        freshnessScope: options.freshnessScope,
+        freshnessScopeId: options.freshnessScopeId,
+        currentProgressPolicy: options.currentProgressPolicy,
+    });
+}
 async function resolveSearchRoots(root, options) {
     const roots = [];
     for (const includePath of [...options.includePaths, ...options.artifactRoots]) {
@@ -223,22 +347,34 @@ async function buildMetricCandidate(root, filePath, options, keys) {
         }
     }
     const mtime = stats.mtime;
-    if (Date.now() - mtime.getTime() < 24 * 60 * 60 * 1000) {
+    const artifactAgeMs = Math.max(0, options.nowMs - mtime.getTime());
+    if (artifactAgeMs < 24 * 60 * 60 * 1000) {
         score += 10;
         reasons.push("recent artifact");
     }
-    const stale = options.staleAfterMs !== undefined && Date.now() - mtime.getTime() > options.staleAfterMs;
+    const beforeFreshnessScope = options.freshAfterMs !== undefined && mtime.getTime() < options.freshAfterMs;
+    const staleByAge = options.staleAfterMs !== undefined && artifactAgeMs > options.staleAfterMs;
+    const stale = beforeFreshnessScope || staleByAge;
+    const freshnessStatus = beforeFreshnessScope ? "pre_scope" : staleByAge ? "stale" : "fresh";
+    const currentRun = options.freshAfterMs === undefined ? null : !beforeFreshnessScope;
     if (stale) {
         score -= 30;
-        reasons.push("stale artifact");
+        reasons.push(beforeFreshnessScope
+            ? `artifact precedes ${options.freshnessScope} freshness scope`
+            : "stale artifact");
     }
     return {
         path: filePath,
         relativePath,
         updatedTime: mtime.toISOString(),
+        artifactAgeMs,
         candidateScore: score,
         reasons,
         stale,
+        freshnessStatus,
+        currentRun,
+        freshnessScope: options.freshnessScope,
+        freshnessScopeId: options.freshnessScopeId ?? null,
     };
 }
 async function countArtifactFiles(root, options) {
@@ -282,18 +418,23 @@ function shouldSkipDirectory(name, relPath, options) {
     }
     return false;
 }
-async function readMetricObservations(candidates) {
+async function readMetricObservations(candidates, options) {
     const observations = [];
     for (const candidate of candidates) {
         try {
             const parsed = JSON.parse(await fs.readFile(candidate.path, "utf8"));
             const metrics = extractNumericMetrics(parsed);
             if (metrics.length > 0) {
+                const lifecycle = extractArtifactLifecycle(parsed);
+                const ineligibleReason = currentProgressIneligibleReason(candidate, lifecycle, options);
                 observations.push({
                     ...candidate,
                     parser: "json",
                     metrics,
                     extractionConfidence: Math.max(...metrics.map((metric) => metric.confidence)),
+                    lifecycle,
+                    eligibleForCurrentProgress: ineligibleReason === null,
+                    ineligibleReason,
                 });
             }
         }
@@ -340,6 +481,43 @@ function extractNumericMetrics(value) {
     }
     return metrics;
 }
+function extractArtifactLifecycle(value) {
+    if (!isRecord(value))
+        return { state: "unknown", status: null, success: null };
+    const status = typeof value["status"] === "string" ? value["status"] : null;
+    const success = booleanOrNull(value["success"]);
+    if (status === "running")
+        return { state: "running", status, success };
+    if (status === "failed")
+        return { state: "failed", status, success };
+    if (success === false)
+        return { state: "failed", status, success };
+    if (status === "completed")
+        return { state: "completed", status, success };
+    if (success === true)
+        return { state: "completed", status, success };
+    return { state: "unknown", status, success };
+}
+function booleanOrNull(value) {
+    return typeof value === "boolean" ? value : null;
+}
+function currentProgressIneligibleReason(candidate, lifecycle, options) {
+    if (options.currentProgressPolicy === "legacy")
+        return null;
+    if (candidate.freshnessStatus === "pre_scope") {
+        return `artifact precedes ${candidate.freshnessScope} freshness scope`;
+    }
+    if (candidate.stale)
+        return "artifact is stale for current progress";
+    if (options.currentProgressPolicy === "allow_live") {
+        return lifecycle.state === "completed" || lifecycle.state === "running"
+            ? null
+            : `artifact lifecycle is ${lifecycle.state}`;
+    }
+    return lifecycle.state === "completed"
+        ? null
+        : `artifact lifecycle is ${lifecycle.state}`;
+}
 function addNumber(metrics, key, keyPath, value, confidence) {
     if (typeof value === "number" && Number.isFinite(value)) {
         metrics.push({ key, keyPath, value, confidence });
@@ -350,6 +528,13 @@ function hasAnyMetric(observation, keys) {
         return observation.metrics.length > 0;
     return keys.some((key) => observation.metrics.some((metric) => metric.key === key));
 }
+function hasCurrentScopeStaleMetricMatch(observations, keys, options) {
+    if (options.freshnessScope === "none")
+        return false;
+    return observations.some((observation) => (observation.stale
+        && !observation.eligibleForCurrentProgress
+        && hasAnyMetric(observation, keys)));
+}
 function selectMetric(observations, keys, aggregation) {
     const matches = matchingMetrics(observations, keys);
     if (matches.length === 0)
@@ -364,15 +549,22 @@ function selectMetric(observations, keys, aggregation) {
         value: best.metric.value,
         parser: best.observation.parser,
         updatedTime: best.observation.updatedTime,
+        artifactAgeMs: best.observation.artifactAgeMs,
         extractionConfidence: best.metric.confidence,
         candidateScore: best.observation.candidateScore,
         stale: best.observation.stale,
+        freshnessStatus: best.observation.freshnessStatus,
+        currentRun: best.observation.currentRun,
+        freshnessScope: best.observation.freshnessScope,
+        freshnessScopeId: best.observation.freshnessScopeId,
     };
 }
 function matchingMetrics(observations, keys) {
     const wanted = new Set(keys);
     const matches = [];
     for (const observation of observations) {
+        if (!observation.eligibleForCurrentProgress)
+            continue;
         for (const metric of observation.metrics) {
             if (wanted.size === 0 || wanted.has(metric.key)) {
                 matches.push({ observation, metric });
@@ -438,8 +630,11 @@ function buildConflict(metricKey, matches) {
             keyPath: metric.keyPath,
             value: metric.value,
             updatedTime: observation.updatedTime,
+            artifactAgeMs: observation.artifactAgeMs,
             extractionConfidence: metric.confidence,
             stale: observation.stale,
+            freshnessStatus: observation.freshnessStatus,
+            currentRun: observation.currentRun,
         })),
     };
 }
@@ -454,9 +649,13 @@ function buildEvidenceCandidates(observations, keys, aggregation) {
         value: metric.value,
         parser: observation.parser,
         updated_time: observation.updatedTime,
+        artifact_age_ms: observation.artifactAgeMs,
         extraction_confidence: metric.confidence,
         candidate_score: observation.candidateScore,
         stale: observation.stale,
+        freshness_status: observation.freshnessStatus,
+        current_run: observation.currentRun,
+        current_progress_eligible: observation.eligibleForCurrentProgress,
         reasons: observation.reasons,
         strategic_correctness: "not_evaluated",
     }));
@@ -465,8 +664,13 @@ function rawCandidates(candidates) {
     return candidates.slice(0, MAX_RAW_CANDIDATES).map((candidate) => ({
         path: candidate.relativePath,
         updated_time: candidate.updatedTime,
+        artifact_age_ms: candidate.artifactAgeMs,
         candidate_score: candidate.candidateScore,
         stale: candidate.stale,
+        freshness_status: candidate.freshnessStatus,
+        current_run: candidate.currentRun,
+        freshness_scope: candidate.freshnessScope,
+        freshness_scope_id: candidate.freshnessScopeId,
         reasons: candidate.reasons,
     }));
 }
@@ -477,7 +681,29 @@ function staleRaw(observations) {
         .map((observation) => ({
         path: observation.relativePath,
         updated_time: observation.updatedTime,
+        artifact_age_ms: observation.artifactAgeMs,
         extraction_confidence: observation.extractionConfidence,
+        freshness_status: observation.freshnessStatus,
+        current_run: observation.currentRun,
+    }));
+}
+function ineligibleRaw(observations) {
+    return observations
+        .filter((observation) => !observation.eligibleForCurrentProgress)
+        .slice(0, MAX_RAW_CANDIDATES)
+        .map((observation) => ({
+        path: observation.relativePath,
+        updated_time: observation.updatedTime,
+        artifact_age_ms: observation.artifactAgeMs,
+        stale: observation.stale,
+        freshness_status: observation.freshnessStatus,
+        current_run: observation.currentRun,
+        freshness_scope: observation.freshnessScope,
+        freshness_scope_id: observation.freshnessScopeId,
+        lifecycle_state: observation.lifecycle.state,
+        lifecycle_status: observation.lifecycle.status,
+        success: observation.lifecycle.success,
+        reason: observation.ineligibleReason,
     }));
 }
 function discoveryRaw(options) {
@@ -489,6 +715,23 @@ function discoveryRaw(options) {
         max_candidates: options.maxCandidates,
         parser_hints: Array.from(options.parserHints),
         stale_after_ms: options.staleAfterMs ?? null,
+        fresh_after_time: options.freshAfterTime ?? null,
+        freshness_scope: options.freshnessScope,
+        freshness_scope_id: options.freshnessScopeId ?? null,
+        current_progress_policy: options.currentProgressPolicy,
+    };
+}
+function freshnessRaw(options, match, observations, currentProgressStatus) {
+    return {
+        scope: options.freshnessScope,
+        scope_id: options.freshnessScopeId ?? null,
+        fresh_after_time: options.freshAfterTime ?? null,
+        selected_path: match?.relativePath ?? null,
+        selected_artifact_age_ms: match?.artifactAgeMs ?? null,
+        selected_freshness_status: match?.freshnessStatus ?? null,
+        selected_current_run: match?.currentRun ?? null,
+        current_progress_status: currentProgressStatus,
+        ineligible_candidate_count: observations.filter((observation) => !observation.eligibleForCurrentProgress).length,
     };
 }
 function compareCandidates(left, right) {
@@ -589,4 +832,10 @@ function unique(values) {
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function parseIsoMs(value) {
+    if (!value)
+        return undefined;
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
 //# sourceMappingURL=artifact-metric-datasource.js.map