pulseed 0.6.5 → 0.6.6

package/README.md

@@ -4,7 +4,7 @@
 
 # PulSeed
 
-PulSeed is a lifelong personal agent that remembers your goals, watches the world with you, and keeps helping move your life forward.
+PulSeed is local-first companion software for goals that take time.
 
 [![Website](https://img.shields.io/badge/Website-pulseed.dev-blue?style=for-the-badge)](https://pulseed.dev)
 [![npm](https://img.shields.io/npm/v/pulseed.svg?style=for-the-badge)](https://www.npmjs.com/package/pulseed)
@@ -15,130 +15,149 @@ PulSeed is a lifelong personal agent that remembers your goals, watches the worl
 
 </div>
 
-PulSeed is a lifelong personal agent for goals that take time.
-Tell it what matters, and it remembers the goal, watches what changes,
-delegates work to agents, verifies progress, and keeps moving your life forward.
+PulSeed pairs a local long-running goal runtime with a companion-software
+design: remember what matters, notice when the situation changes, and bring the
+right tool, agent, or workflow into the moment when help is needed.
 
-Its current technical wedge is long-running goal orchestration, but that is not
-the final category. PulSeed is being built toward a lifelong companion agent
-with durable personal context, presence, proactive dialogue, and safe
-delegation. See [Positioning](docs/positioning.md).
+The current implementation focuses on long-running goal orchestration. It stores
+local state, runs a DurableLoop over goals, delegates bounded work through
+AgentLoop or configured adapters, verifies progress from evidence, and exposes
+the runtime through the CLI, TUI, daemon, schedules, chat, and gateway surfaces.
+The docs separate runnable operating instructions from product and subsystem
+design, so readers can distinguish what the package does today from the broader
+companion-software contract PulSeed is designed around.
 
-The primary entry point is `pulseed`. The normal flow is natural language, not a
-menu of subcommands.
+In plain terms, PulSeed helps you keep goal work, state, progress checks, and
+agent/tool runs organized across time from your local machine.
 
-## Get Started
+## Is PulSeed For Me?
+
+Try PulSeed today if you want to:
+
+- keep a long-running goal and its evidence outside a single chat session
+- run goal work from a local CLI/TUI with inspectable state under `~/.pulseed/`
+- use daemon, schedule, gateway, plugin, memory, and diagnostic surfaces while
+  keeping current behavior separate from product design
+
+PulSeed is not yet:
+
+- a turnkey personal-life automation product
+- a medical, financial, legal, or business-decision advisor
+- a complete sandbox for untrusted commands, plugins, provider tools, or local
+  backends
+
+Recommended first step: install PulSeed, run `pulseed`, complete provider setup,
+and try one low-risk goal in a disposable workspace.
+
+## Quick Start
 
 PulSeed supports Node.js 22 or 24.
 
-Quick install (macOS / Linux):
+macOS / Linux:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/my-name-is-yu/PulSeed/main/scripts/install.sh | bash
 ```
 
-Quick install (Windows / PowerShell):
+Windows / PowerShell:
 
 ```powershell
 irm https://raw.githubusercontent.com/my-name-is-yu/PulSeed/main/scripts/install.ps1 | iex
 ```
 
-Then start PulSeed:
+Then launch PulSeed:
 
 ```bash
 pulseed
 ```
 
-For pinned-tag installs, fallback npm installs, and installer flags, see [Getting Started](docs/getting-started.md).
-
-Then describe the goal in natural language:
+The bare `pulseed` command opens the interactive TUI after provider setup. For
+pinned versions, npm fallback installs, and first-run details, see
+[Getting Started](./docs/start/index.md).
 
-- `Increase test coverage to 90%.`
-- `Show me the current progress.`
-- `Keep this goal moving in the background.`
+## What Exists Now
 
-PulSeed will guide provider and adapter setup when needed.
+- `DurableLoop` controls long-running goal progress, continuation,
+  verification, stall handling, and completion decisions.
+- `AgentLoop` handles bounded tool-using work for tasks, chat turns, and selected
+  runtime phases.
+- Local state lives under `~/.pulseed/` by default and can be overridden with
+  `PULSEED_HOME`.
+- Runtime surfaces include CLI, TUI, daemon, schedules, chat, gateway channels,
+  plugins, memory correction commands, and operational diagnostics.
+- Provider configuration supports OpenAI, Anthropic, and Ollama paths with
+  adapter-specific compatibility.
+- Approval, worktree, verification, and policy gates reduce risk around
+  delegated work, but local backends and plugins still run with the user's
+  privileges.
 
-## Links
+## Common Commands
 
-- [Get Started](docs/getting-started.md)
-- [Positioning](docs/positioning.md)
-- [Docs Index](docs/index.md)
-- [Runtime](docs/runtime.md)
-- [Configuration](docs/configuration.md)
-- [Status](docs/status.md)
-- [Contributing](CONTRIBUTING.md)
-- [Security](SECURITY.md)
-
-## Why PulSeed?
-
-- Lifelong personal-agent orchestration for goals that take time
-- Honest goal negotiation when a target is not realistic as stated
-- Bounded agent execution with verification around delegated work
-- Verified playbook memory that turns successful runs into reusable planning hints
-- Local persistent state under `~/.pulseed/`
-- Multiple runtime surfaces: CLI, chat, TUI, daemon, and cron
-- Support for OpenAI, Anthropic, Ollama, and adapter-based execution paths
-
-## What It Does
+```bash
+pulseed
+pulseed --version
+pulseed setup
+pulseed goal add "Increase test coverage to 90%"
+pulseed run --goal <goal-id>
+pulseed status --goal <goal-id>
+pulseed report --goal <goal-id>
+pulseed daemon start --goal <goal-id>
+pulseed schedule list
+pulseed gateway setup
+pulseed memory history <kind:id>
+```
 
-- `DurableLoop` keeps a goal moving and decides whether to continue, refine,
-  verify, or stop
-- `AgentLoop` handles bounded tool-using work for task execution, chat, and
-  selected runtime phases
-- Centralized AgentLoop profiles keep task execution isolated by default,
-  narrow chat permissions, and run `/review` through a dedicated read-only
-  review posture
-- Dream-backed playbooks can feed verified workflow hints into later task
-  generation without auto-writing executable skills
-- State, reports, schedules, and local memory live under `~/.pulseed/`
-- Software-level approval and verification gates protect delegated work
+For the complete command surface, use `pulseed help` or see the docs:
 
-## Common Surfaces
+- [Docs Map](docs/index.md)
+- [Getting Started](./docs/start/index.md)
+- [Runtime](./docs/operate/runtime.md)
+- [Configuration](./docs/operate/configuration.md)
+- [Status](./docs/operate/status.md)
+- [Architecture Map](./docs/architecture/architecture-map.md)
+- [Module Map](./docs/architecture/module-map.md)
 
-- `pulseed` for the primary interactive workflow
-- `pulseed tui` for the terminal UI
-- `pulseed start` and `pulseed stop` for daemon control
-- `pulseed schedule ...` for schedule management
-- Lower-level commands for scripting, diagnostics, and compatibility
+## How The Docs Are Organized
 
-## Achievements
+Start with the current operating docs when you want to use PulSeed today:
 
-PulSeed completed a 30-hour autonomous dogfood run on
-[Kaggle Playground Series S6E4](https://www.kaggle.com/competitions/playground-series-s6e4).
+- [Getting Started](./docs/start/index.md)
+- [Guide](./docs/start/guide.md)
+- [Concepts](./docs/concepts/index.md)
+- [Reference](docs/reference/index.md)
+- [Architecture](./docs/architecture/index.md)
 
-| Area | Result |
-| --- | --- |
-| Long-running workflow | Ran continuously for about 30 hours, with operator intervention only for deadline-bound submissions. |
-| Final Kaggle result | Finished with `0.97057` balanced accuracy, ranked `1,303 / 4,325` teams, approximately the top `30%`. |
-| Local validation | Improved OOF balanced accuracy from early 0.45-level baselines to a 0.970+ candidate set. |
-| Autonomous exploration | Generated, tested, and compared hypotheses across CatBoost variants, probability adjustment, class weighting, and post-OOF calibration. |
-| Evidence preserved | Kept logs, metrics, OOF predictions, submission candidates, and follow-up engineering issues from the run. |
+Product direction, companion scenarios, and design boundaries live under
+[Product Design](./docs/product/index.md). Design documents,
+audits, and design history live under [Design Documentation](docs/design/index.md).
 
-## Docs and Community
+## Evidence
 
-Start with the public doc map:
+The current public evidence is implementation evidence, not an external
+traction claim. PulSeed has been dogfooded on long-running work, including a
+30-hour autonomous Kaggle Playground Series S6E4 run. A redacted evidence log is
+available at
+[pulseed-kaggle-s6e4-evidence-log](https://github.com/my-name-is-yu/pulseed-kaggle-s6e4-evidence-log).
 
-- [Getting Started](docs/getting-started.md)
-- [Runtime](docs/runtime.md)
-- [Mechanism](docs/mechanism.md)
-- [Configuration](docs/configuration.md)
-- [Architecture Map](docs/architecture-map.md)
+The repository also includes repeatable verification paths for the implemented
+foundation: `npm run check:docs`, `npm run test:dogfood`,
+`npm run dogfood:agentloop:real`, packaged-artifact checks, and CI lanes for
+unit and integration coverage. These show that the product contract is being
+tested through code-backed goal/runtime behavior. They do not claim customer
+adoption, revenue, or broad market pull yet.
 
-For project participation:
+## Contributing
 
-- read [Contributing](CONTRIBUTING.md) before opening a pull request
-- use [Issues](https://github.com/my-name-is-yu/PulSeed/issues) for bugs and
-  feature proposals
-- follow the [Code of Conduct](CODE_OF_CONDUCT.md)
+Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request. For
+security issues, see [SECURITY.md](SECURITY.md).
 
 ## Safety Boundary
 
-PulSeed uses approval gates and verification around delegated work. Native
-`agent_loop` task execution can use isolated git worktrees, and supported CLI
-adapters can be wrapped with a Docker terminal backend. These reduce blast
-radius, but local backends and plugins still run with the user's privileges. See
-[Security](SECURITY.md).
+PulSeed has software-level approval and verification gates. Native `agent_loop`
+task execution can use git worktree isolation, and supported CLI adapters can be
+wrapped with a Docker terminal backend. These are not a complete OS sandbox:
+local backends, shell commands, provider tools, and plugins may still act with
+the user's privileges.
 
 ## License
 

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

@@ -1,7 +1,7 @@
 import type { DataSourceConfig, DataSourceQuery, DataSourceResult, DataSourceType } from "../../base/types/data-source.js";
 import type { IDataSourceAdapter } from "../../platform/observation/data-source-adapter.js";
+import { type FreshnessScope } from "./artifact-metric-discovery.js";
 type Aggregation = "max" | "min" | "count" | "file_count";
-type FreshnessScope = "none" | "goal" | "task" | "run";
 export interface ArtifactMetricFreshnessScope {
     freshAfterTime: string;
     freshnessScope: Exclude<FreshnessScope, "none">;

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;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"}
+{"version":3,"file":"artifact-metric-datasource.d.ts","sourceRoot":"","sources":["../../../src/adapters/datasources/artifact-metric-datasource.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACf,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAC5F,OAAO,EAML,KAAK,cAAc,EAKpB,MAAM,gCAAgC,CAAC;AAExC,KAAK,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,YAAY,CAAC;AAG1D,MAAM,WAAW,4BAA4B;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAChD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AA6DD,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;YAIL,+BAA+B;CAU9C"}

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

@@ -1,23 +1,7 @@
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
+import { buildArtifactMetricScanOptions, countArtifactFiles, discoverMetricCandidates, scanCacheKey, selectCandidatesForKeys, } from "./artifact-metric-discovery.js";
 const BUILTIN_SOURCE_ID = "ds_builtin_workspace_artifacts";
-const DEFAULT_METRIC_FILE_NAMES = ["metrics.json", "result.json"];
-const DEFAULT_ARTIFACT_ROOTS = ["artifacts", "experiments", "runs", "reports", "outputs", "results", "logs"];
-const DEFAULT_EXCLUDE_DIRS = new Set([
-    ".cache",
-    ".git",
-    ".mypy_cache",
-    ".pytest_cache",
-    ".venv",
-    "__pycache__",
-    "env",
-    "node_modules",
-    "venv",
-]);
-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()) {
@@ -209,30 +193,7 @@ export class ArtifactMetricDataSourceAdapter {
         return configuredPath ? path.resolve(configuredPath) : process.cwd();
     }
     scanOptions() {
-        return {
-            metricFileNames: new Set(this.config.connection.metric_file_names ?? DEFAULT_METRIC_FILE_NAMES),
-            artifactRoots: unique([
-                ...(this.config.connection.artifact_roots ?? []),
-                ...(this.config.connection.artifact_roots ? [] : DEFAULT_ARTIFACT_ROOTS),
-            ].map(normalizeRelativePath)),
-            includePaths: unique((this.config.connection.include_paths ?? []).map(normalizeRelativePath)),
-            parserHints: new Set(this.config.connection.parser_hints ?? ["json"]),
-            excludeDirs: new Set([...(this.config.connection.exclude_dirs ?? []), ...DEFAULT_EXCLUDE_DIRS]),
-            excludePaths: new Set([
-                ...Array.from(DEFAULT_EXCLUDE_PATHS),
-                ...(this.config.connection.exclude_paths ?? []),
-            ].map(normalizeRelativePath)),
-            maxMetricFiles: this.config.connection.max_metric_files ?? DEFAULT_MAX_METRIC_FILES,
-            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(),
-        };
+        return buildArtifactMetricScanOptions(this.config);
     }
     async discoverMetricCandidatesForPass(root, options) {
         const cacheKey = scanCacheKey(root, options);
@@ -245,179 +206,6 @@ export class ArtifactMetricDataSourceAdapter {
         return snapshot;
     }
 }
-async function discoverMetricCandidates(root, options, keys) {
-    const discovered = new Map();
-    for (const includePath of options.includePaths) {
-        if (discovered.size >= options.maxMetricFiles)
-            break;
-        const absolute = path.resolve(root, includePath);
-        if (!isInsideRoot(root, absolute) || !(await isFile(absolute)))
-            continue;
-        if (!options.metricFileNames.has(path.basename(absolute)))
-            continue;
-        const candidate = await buildMetricCandidate(root, absolute, options, keys);
-        discovered.set(candidate.path, candidate);
-    }
-    const searchRoots = await resolveSearchRoots(root, options);
-    for (const searchRoot of searchRoots) {
-        if (discovered.size >= options.maxMetricFiles)
-            break;
-        await walkFiles(root, searchRoot, options, async (filePath) => {
-            if (discovered.size >= options.maxMetricFiles)
-                return;
-            if (!options.metricFileNames.has(path.basename(filePath)))
-                return;
-            const candidate = await buildMetricCandidate(root, filePath, options, keys);
-            discovered.set(candidate.path, candidate);
-        });
-    }
-    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]) {
-        const absolute = path.resolve(root, includePath);
-        if (!isInsideRoot(root, absolute))
-            continue;
-        if (await isDirectory(absolute))
-            roots.push(absolute);
-    }
-    if (roots.length === 0)
-        roots.push(root);
-    return unique(roots);
-}
-async function buildMetricCandidate(root, filePath, options, keys) {
-    const stats = await fs.stat(filePath);
-    const relativePath = normalizeRelativePath(path.relative(root, filePath));
-    const reasons = [];
-    let score = 0;
-    if (options.metricFileNames.has(path.basename(filePath))) {
-        score += 35;
-        reasons.push("metric filename match");
-    }
-    const matchedRoot = options.artifactRoots.find((rootHint) => relativePath === rootHint || relativePath.startsWith(`${rootHint}/`));
-    if (matchedRoot) {
-        score += 20;
-        reasons.push(`artifact root match: ${matchedRoot}`);
-    }
-    for (const key of keys) {
-        if (relativePath.toLowerCase().includes(key.toLowerCase())) {
-            score += 8;
-            reasons.push(`path metric hint: ${key}`);
-            break;
-        }
-    }
-    const mtime = stats.mtime;
-    const artifactAgeMs = Math.max(0, options.nowMs - mtime.getTime());
-    if (artifactAgeMs < 24 * 60 * 60 * 1000) {
-        score += 10;
-        reasons.push("recent artifact");
-    }
-    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(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) {
-    let count = 0;
-    await walkFiles(root, root, options, async () => {
-        if (count < options.maxArtifactFiles)
-            count += 1;
-    });
-    return count;
-}
-async function walkFiles(root, startDir, options, onFile) {
-    async function visit(dir) {
-        let entries;
-        try {
-            entries = await fs.readdir(dir, { withFileTypes: true });
-        }
-        catch {
-            return;
-        }
-        for (const entry of entries) {
-            const fullPath = path.join(dir, entry.name);
-            const relPath = normalizeRelativePath(path.relative(root, fullPath));
-            if (entry.isDirectory()) {
-                if (shouldSkipDirectory(entry.name, relPath, options))
-                    continue;
-                await visit(fullPath);
-            }
-            else if (entry.isFile()) {
-                await onFile(fullPath);
-            }
-        }
-    }
-    await visit(startDir);
-}
-function shouldSkipDirectory(name, relPath, options) {
-    if (options.excludeDirs.has(name))
-        return true;
-    for (const excludedPath of options.excludePaths) {
-        if (relPath === excludedPath || relPath.startsWith(`${excludedPath}/`))
-            return true;
-    }
-    return false;
-}
 async function readMetricObservations(candidates, options) {
     const observations = [];
     for (const candidate of candidates) {
@@ -751,11 +539,6 @@ function freshnessRaw(options, match, observations, currentProgressStatus) {
         ineligible_candidate_count: observations.filter((observation) => !observation.eligibleForCurrentProgress).length,
     };
 }
-function compareCandidates(left, right) {
-    if (left.candidateScore !== right.candidateScore)
-        return right.candidateScore - left.candidateScore;
-    return Date.parse(right.updatedTime) - Date.parse(left.updatedTime);
-}
 function resolveAggregation(dimensionName, expression, config) {
     const configured = config.connection.dimension_aggregations?.[dimensionName];
     if (configured)
@@ -820,39 +603,10 @@ function isRecognizedBestMetricDimension(dimensionName) {
 function prefersLowerMetric(dimensionName) {
     return /loss|error|rmse|mae|mse/i.test(dimensionName);
 }
-function normalizeRelativePath(value) {
-    return value.split(path.sep).join("/").replace(/^\.\//, "");
-}
-function isInsideRoot(root, candidate) {
-    const relative = path.relative(root, candidate);
-    return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
-}
-async function isDirectory(filePath) {
-    try {
-        return (await fs.stat(filePath)).isDirectory();
-    }
-    catch {
-        return false;
-    }
-}
-async function isFile(filePath) {
-    try {
-        return (await fs.stat(filePath)).isFile();
-    }
-    catch {
-        return false;
-    }
-}
 function unique(values) {
     return Array.from(new Set(values.filter(Boolean)));
 }
 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