@codeledger/codeledger-runtime 0.7.8

package/dist/types.d.ts

@@ -0,0 +1,197 @@
+import type { CodeLedgerConfig, ContextBundle, PreflightResult } from '@codeledger/types';
+export type TaskRuntimeMode = 'observe' | 'warn' | 'block';
+export type SupportedAgent = 'codex' | 'claude' | 'claude_code' | 'cursor' | 'windsurf' | 'antigravity' | 'generic';
+export interface RuntimeContext {
+    config: CodeLedgerConfig;
+    configPath: string;
+    indexPath: string;
+}
+export interface EnsureScanFreshOptions {
+    cwd: string;
+    staleAfterSeconds?: number;
+    log?: (...args: unknown[]) => void;
+}
+export interface EnsureScanFreshResult extends RuntimeContext {
+    refreshed: boolean;
+}
+export interface BuildBundleOptions {
+    cwd: string;
+    task: string;
+    budget?: string;
+    maxFiles?: string;
+    expand?: boolean;
+    explain?: boolean;
+    scope?: string[];
+    includeNearMisses?: boolean;
+    includeBlastRadius?: boolean;
+    layerOrder?: boolean;
+}
+export interface BuildBundleResult extends RuntimeContext {
+    bundle: ContextBundle;
+    bundlePath: string;
+}
+export interface TaskRuntimeOptions {
+    cwd: string;
+    task: string;
+    taskId?: string;
+    sessionId?: string;
+    agent: SupportedAgent;
+    mode?: TaskRuntimeMode;
+    staleAfterSeconds?: number;
+    budget?: string;
+    maxFiles?: string;
+    expand?: boolean;
+    explain?: boolean;
+    scope?: string[];
+    includeNearMisses?: boolean;
+    includeBlastRadius?: boolean;
+    layerOrder?: boolean;
+    agentBin?: string;
+    dryRun?: boolean;
+    agentEnv?: Record<string, string>;
+    onStatus?: (event: RuntimeStatusEvent) => void;
+    warmBundlePath?: string;
+}
+export interface PreflightStatus {
+    result: PreflightResult;
+    errors: string[];
+    warnings: string[];
+    blocked: boolean;
+}
+export interface AgentLaunchResult {
+    command: string;
+    args: string[];
+    launched: boolean;
+    exitCode: number | null;
+    durationMs: number;
+    reason?: string;
+}
+export interface RuntimeValueSignals {
+    filesSkipped: number;
+    scanReused: boolean;
+    bundleReused: boolean;
+    estimatedTimeSavedSeconds: number;
+    duplicateRisk?: string;
+    outOfScopeWarning?: string;
+}
+export interface TaskSessionRecord {
+    runId: string;
+    taskId?: string;
+    sessionId?: string;
+    task: string;
+    agent: SupportedAgent;
+    mode: TaskRuntimeMode;
+    status: 'running' | 'blocked' | 'skipped' | 'ok' | 'failed';
+    startedAt: string;
+    finishedAt?: string;
+    gitBranch?: string;
+    gitHead?: string;
+    bundleId?: string;
+    bundlePath?: string;
+    bundleMarkdownPath?: string;
+    bundleConfidenceLevel?: string;
+    bundleConfidenceScore?: number;
+    scanRefreshed?: boolean;
+    contextReuse?: boolean;
+    filesTouched?: string[];
+    preflightErrors?: string[];
+    preflightWarnings?: string[];
+    valueSignals?: RuntimeValueSignals;
+    agentCommand?: string;
+    agentArgs?: string[];
+    agentReason?: string;
+}
+export interface TaskRuntimeResult {
+    runId: string;
+    taskId?: string;
+    sessionId?: string;
+    runFilePath: string;
+    sessionFilePath: string;
+    startedAt: string;
+    finishedAt: string;
+    bundleId: string;
+    bundlePath: string;
+    bundleMarkdownPath: string;
+    bundleFiles: string[];
+    bundleTokens: number;
+    bundleConfidenceLevel?: string;
+    bundleConfidenceScore?: number;
+    relevantTests: string[];
+    indexedFiles: number;
+    indexedTests: number;
+    skippedFilesEstimate: number;
+    savedTokensEstimate: number;
+    estimatedTimeSavedSeconds: number;
+    contextReuse: boolean;
+    valueSignals: RuntimeValueSignals;
+    intent: string;
+    repoRoot: string;
+    gitBranch: string;
+    gitHead: string;
+    filesTouched: string[];
+    scanRefreshed: boolean;
+    preflight: PreflightStatus;
+    agent: AgentLaunchResult;
+}
+export interface TaskLineageRecord {
+    version: 1;
+    ts: string;
+    runId: string;
+    taskId: string;
+    sessionId?: string;
+    task: string;
+    agent: SupportedAgent;
+    status: 'blocked' | 'skipped' | 'ok' | 'failed';
+    branch: string;
+    startGitHead: string;
+    finishedGitHead: string;
+    bundleId: string;
+    bundlePath: string;
+    bundleConfidenceLevel?: string;
+    bundleConfidenceScore?: number;
+    contextReuse: boolean;
+    filesTouched: string[];
+    relevantTests: string[];
+    warnings: string[];
+    violations: string[];
+    valueSignals: RuntimeValueSignals;
+    startedAt: string;
+    finishedAt: string;
+}
+export type RuntimeStatusEvent = {
+    kind: 'session_created';
+    runId: string;
+    intent: string;
+    repoRoot: string;
+    gitBranch: string;
+} | {
+    kind: 'scan_ready';
+    refreshed: boolean;
+    indexedFiles: number;
+    indexedTests: number;
+} | {
+    kind: 'bundle_ready';
+    bundleId: string;
+    bundleFiles: string[];
+    relevantTests: string[];
+    bundleTokens: number;
+    confidenceLevel?: string;
+    confidenceScore?: number;
+    skippedFilesEstimate: number;
+    savedTokensEstimate: number;
+    estimatedTimeSavedSeconds: number;
+    bundleReused: boolean;
+    duplicateRisk?: string;
+} | {
+    kind: 'preflight_ready';
+    blocked: boolean;
+    warnings: string[];
+    errors: string[];
+} | {
+    kind: 'agent_finished';
+    launched: boolean;
+    exitCode: number | null;
+    reason?: string;
+    filesTouched: string[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@codeledger/codeledger-runtime",
+  "version": "00.7.8",
+  "type": "module",
+  "description": "Ambient task runtime for CodeLedger agent sessions",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/codeledgerECF/codeledger.git",
+    "directory": "packages/codeledger-runtime"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@codeledger/types": "00.7.8",
+    "@codeledger/core-engine": "00.7.8",
+    "@codeledger/instrument": "00.7.8",
+    "@codeledger/repo": "00.7.8",
+    "@codeledger/harness": "00.7.8"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}