@devflow-tools/sdk 0.16.18 → 0.16.20

package/dist/capability-rollout.d.ts

@@ -0,0 +1,30 @@
+export type RolloutMode = 'off' | 'shadow' | 'on';
+export interface CapabilityRolloutConfig {
+    truthfulWorkflow: RolloutMode;
+    truthfulHealth: RolloutMode;
+    retrievalSessions: RolloutMode;
+    outcomeAttribution: RolloutMode;
+    projectToolProfile: RolloutMode;
+    compactSessionStart: RolloutMode;
+    learningOverlays: RolloutMode;
+    repeatedEvaluation: RolloutMode;
+    worktreeWorkers: RolloutMode;
+}
+export type CapabilityRolloutKey = keyof CapabilityRolloutConfig;
+export type CapabilityRolloutDiagnosticCode = 'config_read_error' | 'malformed_config' | 'invalid_rollout_config' | 'invalid_rollout_value' | 'unknown_rollout_key';
+export interface CapabilityRolloutDiagnostic {
+    code: CapabilityRolloutDiagnosticCode;
+    source: 'project' | 'environment';
+    message: string;
+    key?: CapabilityRolloutKey;
+    unknownKey?: string;
+    environmentVariable?: string;
+    value?: unknown;
+}
+export interface CapabilityRolloutResolution {
+    config: CapabilityRolloutConfig;
+    diagnostics: CapabilityRolloutDiagnostic[];
+}
+export declare const DEFAULT_CAPABILITY_ROLLOUT: Readonly<CapabilityRolloutConfig>;
+export declare function resolveCapabilityRollout(projectRoot: string, env?: NodeJS.ProcessEnv): CapabilityRolloutResolution;
+//# sourceMappingURL=capability-rollout.d.ts.map

package/dist/capability-rollout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-rollout.d.ts","sourceRoot":"","sources":["../src/capability-rollout.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;AAElD,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,EAAE,WAAW,CAAC;IAC9B,cAAc,EAAE,WAAW,CAAC;IAC5B,iBAAiB,EAAE,WAAW,CAAC;IAC/B,kBAAkB,EAAE,WAAW,CAAC;IAChC,kBAAkB,EAAE,WAAW,CAAC;IAChC,mBAAmB,EAAE,WAAW,CAAC;IACjC,gBAAgB,EAAE,WAAW,CAAC;IAC9B,kBAAkB,EAAE,WAAW,CAAC;IAChC,eAAe,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,uBAAuB,CAAC;AAEjE,MAAM,MAAM,+BAA+B,GACvC,mBAAmB,GACnB,kBAAkB,GAClB,wBAAwB,GACxB,uBAAuB,GACvB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,+BAA+B,CAAC;IACtC,MAAM,EAAE,SAAS,GAAG,aAAa,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,oBAAoB,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,uBAAuB,CAAC;IAChC,WAAW,EAAE,2BAA2B,EAAE,CAAC;CAC5C;AAED,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,uBAAuB,CAUvE,CAAC;AAwBH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,2BAA2B,CAwD7B"}

package/dist/capability-rollout.js

@@ -0,0 +1,153 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+export const DEFAULT_CAPABILITY_ROLLOUT = Object.freeze({
+    truthfulWorkflow: 'off',
+    truthfulHealth: 'shadow',
+    retrievalSessions: 'off',
+    outcomeAttribution: 'off',
+    projectToolProfile: 'off',
+    compactSessionStart: 'off',
+    learningOverlays: 'off',
+    repeatedEvaluation: 'off',
+    worktreeWorkers: 'off',
+});
+const CONFIG_PATH = join('.devflow', 'config.json');
+const ENVIRONMENT_VARIABLES = {
+    truthfulWorkflow: 'DEVFLOW_ROLLOUT_TRUTHFUL_WORKFLOW',
+    truthfulHealth: 'DEVFLOW_ROLLOUT_TRUTHFUL_HEALTH',
+    retrievalSessions: 'DEVFLOW_ROLLOUT_RETRIEVAL_SESSIONS',
+    outcomeAttribution: 'DEVFLOW_ROLLOUT_OUTCOME_ATTRIBUTION',
+    projectToolProfile: 'DEVFLOW_ROLLOUT_PROJECT_TOOL_PROFILE',
+    compactSessionStart: 'DEVFLOW_ROLLOUT_COMPACT_SESSION_START',
+    learningOverlays: 'DEVFLOW_ROLLOUT_LEARNING_OVERLAYS',
+    repeatedEvaluation: 'DEVFLOW_ROLLOUT_REPEATED_EVALUATION',
+    worktreeWorkers: 'DEVFLOW_ROLLOUT_WORKTREE_WORKERS',
+};
+const ROLLOUT_KEYS = Object.keys(ENVIRONMENT_VARIABLES);
+const ROLLOUT_KEY_SET = new Set(ROLLOUT_KEYS);
+export function resolveCapabilityRollout(projectRoot, env = process.env) {
+    const config = { ...DEFAULT_CAPABILITY_ROLLOUT };
+    const projectResult = readProjectRollout(projectRoot);
+    const diagnostics = [...projectResult.diagnostics];
+    if (projectResult.rollout) {
+        const unknownKeys = Object.keys(projectResult.rollout)
+            .filter((key) => !ROLLOUT_KEY_SET.has(key))
+            .sort();
+        for (const key of unknownKeys) {
+            diagnostics.push({
+                code: 'unknown_rollout_key',
+                source: 'project',
+                unknownKey: key,
+                value: projectResult.rollout[key],
+                message: `Ignoring unknown project rollout key ${key}.`,
+            });
+        }
+        for (const key of ROLLOUT_KEYS) {
+            const value = projectResult.rollout[key];
+            if (value === undefined)
+                continue;
+            if (isRolloutMode(value)) {
+                config[key] = value;
+            }
+            else {
+                diagnostics.push({
+                    code: 'invalid_rollout_value',
+                    source: 'project',
+                    key,
+                    value,
+                    message: `Ignoring invalid project rollout value for ${key}; expected off, shadow, or on.`,
+                });
+            }
+        }
+    }
+    for (const key of ROLLOUT_KEYS) {
+        const environmentVariable = ENVIRONMENT_VARIABLES[key];
+        const value = env[environmentVariable];
+        if (value === undefined)
+            continue;
+        if (isRolloutMode(value)) {
+            config[key] = value;
+        }
+        else {
+            config[key] = DEFAULT_CAPABILITY_ROLLOUT[key];
+            diagnostics.push({
+                code: 'invalid_rollout_value',
+                source: 'environment',
+                key,
+                environmentVariable,
+                value,
+                message: `Ignoring invalid environment rollout value in ${environmentVariable}; expected off, shadow, or on.`,
+            });
+        }
+    }
+    return { config, diagnostics };
+}
+function readProjectRollout(projectRoot) {
+    const path = join(projectRoot, CONFIG_PATH);
+    let rawConfig;
+    try {
+        rawConfig = readFileSync(path, 'utf8');
+    }
+    catch (error) {
+        if (hasErrorCode(error, 'ENOENT'))
+            return { rollout: null, diagnostics: [] };
+        return {
+            rollout: null,
+            diagnostics: [{
+                    code: 'config_read_error',
+                    source: 'project',
+                    message: `Could not read rollout configuration from ${CONFIG_PATH}; using lower-precedence values.`,
+                }],
+        };
+    }
+    let config;
+    try {
+        config = JSON.parse(rawConfig);
+    }
+    catch {
+        return {
+            rollout: null,
+            diagnostics: [{
+                    code: 'malformed_config',
+                    source: 'project',
+                    message: `Could not parse ${CONFIG_PATH}; using lower-precedence values.`,
+                }],
+        };
+    }
+    if (!isRecord(config)) {
+        return {
+            rollout: null,
+            diagnostics: [{
+                    code: 'malformed_config',
+                    source: 'project',
+                    value: config,
+                    message: `${CONFIG_PATH} must contain a JSON object; using lower-precedence values.`,
+                }],
+        };
+    }
+    const rollout = config.rollout;
+    if (rollout === undefined)
+        return { rollout: null, diagnostics: [] };
+    if (!isRecord(rollout)) {
+        return {
+            rollout: null,
+            diagnostics: [{
+                    code: 'invalid_rollout_config',
+                    source: 'project',
+                    value: rollout,
+                    message: `The rollout field in ${CONFIG_PATH} must be an object; using lower-precedence values.`,
+                }],
+        };
+    }
+    return { rollout, diagnostics: [] };
+}
+function hasErrorCode(error, code) {
+    return isRecord(error) && error.code === code;
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function isRolloutMode(value) {
+    return value === 'off' || value === 'shadow' || value === 'on';
+}
+//# sourceMappingURL=capability-rollout.js.map

package/dist/capability-rollout.js.map

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

package/dist/capability-rollout.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=capability-rollout.test.d.ts.map

package/dist/capability-rollout.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-rollout.test.d.ts","sourceRoot":"","sources":["../src/capability-rollout.test.ts"],"names":[],"mappings":""}

package/dist/capability-rollout.test.js

@@ -0,0 +1,209 @@
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { DEFAULT_CAPABILITY_ROLLOUT, resolveCapabilityRollout, } from './capability-rollout.js';
+describe('capability rollout', () => {
+    const roots = [];
+    afterEach(() => {
+        for (const root of roots.splice(0))
+            rmSync(root, { recursive: true, force: true });
+    });
+    it('uses safe defaults when no project configuration exists', () => {
+        const root = createProjectRoot();
+        const resolution = resolveCapabilityRollout(root, {});
+        expect(resolution.config).toEqual({
+            truthfulWorkflow: 'off',
+            truthfulHealth: 'shadow',
+            retrievalSessions: 'off',
+            outcomeAttribution: 'off',
+            projectToolProfile: 'off',
+            compactSessionStart: 'off',
+            learningOverlays: 'off',
+            repeatedEvaluation: 'off',
+            worktreeWorkers: 'off',
+        });
+        expect(resolution.config).not.toBe(DEFAULT_CAPABILITY_ROLLOUT);
+        expect(resolution.diagnostics).toEqual([]);
+    });
+    it('exports immutable defaults and returns a mutable clone', () => {
+        const root = createProjectRoot();
+        const resolution = resolveCapabilityRollout(root, {});
+        expect(Object.isFrozen(DEFAULT_CAPABILITY_ROLLOUT)).toBe(true);
+        expect(Reflect.set(DEFAULT_CAPABILITY_ROLLOUT, 'truthfulWorkflow', 'on')).toBe(false);
+        expect(DEFAULT_CAPABILITY_ROLLOUT.truthfulWorkflow).toBe('off');
+        expect(Reflect.set(resolution.config, 'truthfulWorkflow', 'on')).toBe(true);
+        expect(resolution.config.truthfulWorkflow).toBe('on');
+    });
+    it('applies valid project rollout configuration over defaults', () => {
+        const root = createProjectRoot({
+            rollout: {
+                truthfulWorkflow: 'shadow',
+                truthfulHealth: 'on',
+                worktreeWorkers: 'on',
+            },
+        });
+        expect(resolveCapabilityRollout(root, {})).toEqual({
+            config: {
+                ...DEFAULT_CAPABILITY_ROLLOUT,
+                truthfulWorkflow: 'shadow',
+                truthfulHealth: 'on',
+                worktreeWorkers: 'on',
+            },
+            diagnostics: [],
+        });
+    });
+    it('gives valid environment overrides precedence over project configuration', () => {
+        const root = createProjectRoot({
+            rollout: {
+                truthfulWorkflow: 'shadow',
+                truthfulHealth: 'off',
+            },
+        });
+        const resolution = resolveCapabilityRollout(root, {
+            DEVFLOW_ROLLOUT_TRUTHFUL_WORKFLOW: 'on',
+            DEVFLOW_ROLLOUT_TRUTHFUL_HEALTH: 'shadow',
+        });
+        expect(resolution.config.truthfulWorkflow).toBe('on');
+        expect(resolution.config.truthfulHealth).toBe('shadow');
+        expect(resolution.diagnostics).toEqual([]);
+    });
+    it('rejects invalid values without enabling features', () => {
+        const root = createProjectRoot({
+            rollout: {
+                truthfulWorkflow: true,
+                truthfulHealth: 'ON',
+                retrievalSessions: 'shadow',
+            },
+        });
+        const resolution = resolveCapabilityRollout(root, {
+            DEVFLOW_ROLLOUT_RETRIEVAL_SESSIONS: 'enabled',
+            DEVFLOW_ROLLOUT_WORKTREE_WORKERS: 'yes',
+        });
+        expect(resolution.config.truthfulWorkflow).toBe('off');
+        expect(resolution.config.truthfulHealth).toBe('shadow');
+        expect(resolution.config.retrievalSessions).toBe('off');
+        expect(resolution.config.worktreeWorkers).toBe('off');
+        expect(resolution.diagnostics).toEqual([
+            expect.objectContaining({ source: 'project', key: 'truthfulWorkflow', value: true }),
+            expect.objectContaining({ source: 'project', key: 'truthfulHealth', value: 'ON' }),
+            expect.objectContaining({ source: 'environment', key: 'retrievalSessions', value: 'enabled' }),
+            expect.objectContaining({ source: 'environment', key: 'worktreeWorkers', value: 'yes' }),
+        ]);
+    });
+    it('resets a project capability to its default for an invalid environment override', () => {
+        const root = createProjectRoot({
+            rollout: {
+                retrievalSessions: 'on',
+            },
+        });
+        const resolution = resolveCapabilityRollout(root, {
+            DEVFLOW_ROLLOUT_RETRIEVAL_SESSIONS: 'enabled',
+        });
+        expect(resolution.config.retrievalSessions).toBe(DEFAULT_CAPABILITY_ROLLOUT.retrievalSessions);
+        expect(resolution.diagnostics).toEqual([{
+                code: 'invalid_rollout_value',
+                source: 'environment',
+                key: 'retrievalSessions',
+                environmentVariable: 'DEVFLOW_ROLLOUT_RETRIEVAL_SESSIONS',
+                value: 'enabled',
+                message: 'Ignoring invalid environment rollout value in DEVFLOW_ROLLOUT_RETRIEVAL_SESSIONS; expected off, shadow, or on.',
+            }]);
+    });
+    it('diagnoses unknown project rollout keys in deterministic order without enabling them', () => {
+        const root = createProjectRoot({
+            rollout: {
+                zetaCapability: 'on',
+                worktreeWorker: 'on',
+                alphaCapability: 'shadow',
+            },
+        });
+        const resolution = resolveCapabilityRollout(root, {});
+        expect(resolution.config.worktreeWorkers).toBe('off');
+        expect(resolution.diagnostics).toEqual([
+            {
+                code: 'unknown_rollout_key',
+                source: 'project',
+                unknownKey: 'alphaCapability',
+                value: 'shadow',
+                message: 'Ignoring unknown project rollout key alphaCapability.',
+            },
+            {
+                code: 'unknown_rollout_key',
+                source: 'project',
+                unknownKey: 'worktreeWorker',
+                value: 'on',
+                message: 'Ignoring unknown project rollout key worktreeWorker.',
+            },
+            {
+                code: 'unknown_rollout_key',
+                source: 'project',
+                unknownKey: 'zetaCapability',
+                value: 'on',
+                message: 'Ignoring unknown project rollout key zetaCapability.',
+            },
+        ]);
+    });
+    it('does not throw or diagnose a missing configuration file', () => {
+        const root = createProjectRoot();
+        expect(() => resolveCapabilityRollout(root, {})).not.toThrow();
+        expect(resolveCapabilityRollout(root, {})).toEqual({
+            config: DEFAULT_CAPABILITY_ROLLOUT,
+            diagnostics: [],
+        });
+    });
+    it('diagnoses a configuration path that exists but cannot be read as a file', () => {
+        const root = createProjectRoot();
+        mkdirSync(configPath(root));
+        const resolution = resolveCapabilityRollout(root, {});
+        expect(resolution.config).toEqual(DEFAULT_CAPABILITY_ROLLOUT);
+        expect(resolution.diagnostics).toEqual([{
+                code: 'config_read_error',
+                source: 'project',
+                message: 'Could not read rollout configuration from .devflow/config.json; using lower-precedence values.',
+            }]);
+    });
+    it('does not throw for malformed configuration and still applies valid environment values', () => {
+        const root = createProjectRoot();
+        writeFileSync(configPath(root), '{"rollout":');
+        const resolution = resolveCapabilityRollout(root, {
+            DEVFLOW_ROLLOUT_TRUTHFUL_WORKFLOW: 'shadow',
+        });
+        expect(resolution.config).toEqual({
+            ...DEFAULT_CAPABILITY_ROLLOUT,
+            truthfulWorkflow: 'shadow',
+        });
+        expect(resolution.diagnostics).toEqual([
+            expect.objectContaining({ code: 'malformed_config', source: 'project' }),
+        ]);
+    });
+    it('only reads rollout and preserves unrelated project configuration fields', () => {
+        const root = createProjectRoot({
+            projectName: 'kept',
+            customPlugin: { enabled: true },
+            rollout: { outcomeAttribution: 'on' },
+        });
+        const path = configPath(root);
+        const before = readFileSync(path, 'utf8');
+        const resolution = resolveCapabilityRollout(root, {});
+        expect(resolution.config.outcomeAttribution).toBe('on');
+        expect(readFileSync(path, 'utf8')).toBe(before);
+        expect(JSON.parse(before)).toEqual({
+            projectName: 'kept',
+            customPlugin: { enabled: true },
+            rollout: { outcomeAttribution: 'on' },
+        });
+    });
+    function createProjectRoot(config) {
+        const root = mkdtempSync(join(tmpdir(), 'devflow-capability-rollout-'));
+        roots.push(root);
+        mkdirSync(join(root, '.devflow'));
+        if (config)
+            writeFileSync(configPath(root), JSON.stringify(config, null, 2));
+        return root;
+    }
+    function configPath(root) {
+        return join(root, '.devflow', 'config.json');
+    }
+});
+//# sourceMappingURL=capability-rollout.test.js.map

package/dist/capability-rollout.test.js.map

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

package/dist/index.d.ts

@@ -24,4 +24,5 @@ export * from "./runtime-endpoint.js";
 export * from "./auth.js";
 export * from "./plugin-workflow.js";
 export * from "./claude-hook-runtime.js";
+export * from "./capability-rollout.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -24,4 +24,5 @@ export * from "./runtime-endpoint.js";
 export * from "./auth.js";
 export * from "./plugin-workflow.js";
 export * from "./claude-hook-runtime.js";
+export * from "./capability-rollout.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC"}

package/dist/types/index.d.ts

@@ -9,4 +9,5 @@ export * from "./telemetry.js";
 export * from "./retrieval.js";
 export * from "./doctor.js";
 export * from "./task-context-envelope.js";
+export * from "./retrieval-session.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC"}

package/dist/types/index.js

@@ -9,4 +9,5 @@ export * from "./telemetry.js";
 export * from "./retrieval.js";
 export * from "./doctor.js";
 export * from "./task-context-envelope.js";
+export * from "./retrieval-session.js";
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC"}

package/dist/types/retrieval-session.d.ts

@@ -0,0 +1,56 @@
+import type { CanonicalTaskIntent, RetrievalQualitySummary } from './task-context-envelope.js';
+export declare const RETRIEVAL_MAX_CYCLES: 3;
+export type RetrievalSessionState = 'open' | 'satisfied' | 'exhausted' | 'expired';
+export type RetrievalGapKind = 'target' | 'caller' | 'route' | 'resource' | 'test' | 'configuration' | 'symbol_ambiguity' | 'memory_applicability' | 'knowledge_version' | 'runtime_evidence' | 'unavailable_channel';
+export type RetrievalGapResolver = 'codegraph' | 'memory' | 'knowledge' | 'analyzer' | 'none';
+export interface RetrievalGap {
+    kind: RetrievalGapKind;
+    target?: string;
+    reason: string;
+    evidence: string[];
+    resolver: RetrievalGapResolver;
+    priority: number;
+}
+export interface RetrievalCycle {
+    cycle: number;
+    gaps: RetrievalGap[];
+    selectedIds: string[];
+    rejectedIds: string[];
+    tokenCost: number;
+    remainingTokenBudget: number;
+    quality: RetrievalQualitySummary;
+    receipt: string;
+    evidenceHash: string;
+    createdAt: number;
+}
+export interface RetrievalSession {
+    id: string;
+    requestId: string;
+    projectRoot: string;
+    sessionId: string;
+    executionId?: string;
+    query: string;
+    intent: CanonicalTaskIntent;
+    state: RetrievalSessionState;
+    cycle: number;
+    maxCycles: typeof RETRIEVAL_MAX_CYCLES;
+    initialTokenBudget: number;
+    remainingTokenBudget: number;
+    baselineReceipt: string;
+    finalReceipt?: string;
+    cycles: RetrievalCycle[];
+    createdAt: number;
+    updatedAt: number;
+    expiresAt: number;
+}
+export interface RetrievalRefinementInput {
+    retrievalSessionId?: string;
+    baselineReceipt?: string;
+    missingContext?: Array<{
+        kind: RetrievalGapKind;
+        target?: string;
+        reason: string;
+        evidence?: string[];
+    }>;
+}
+//# sourceMappingURL=retrieval-session.d.ts.map

package/dist/types/retrieval-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval-session.d.ts","sourceRoot":"","sources":["../../src/types/retrieval-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAE/F,eAAO,MAAM,oBAAoB,EAAG,CAAU,CAAC;AAE/C,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;AAEnF,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,UAAU,GACV,MAAM,GACN,eAAe,GACf,kBAAkB,GAClB,sBAAsB,GACtB,mBAAmB,GACnB,kBAAkB,GAClB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;AAE9F,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,uBAAuB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,qBAAqB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,oBAAoB,CAAC;IACvC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,KAAK,CAAC;QACrB,IAAI,EAAE,gBAAgB,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC,CAAC;CACJ"}

package/dist/types/retrieval-session.js

@@ -0,0 +1,2 @@
+export const RETRIEVAL_MAX_CYCLES = 3;
+//# sourceMappingURL=retrieval-session.js.map

package/dist/types/retrieval-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval-session.js","sourceRoot":"","sources":["../../src/types/retrieval-session.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAU,CAAC"}

package/dist/types/retrieval-session.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=retrieval-session.test.d.ts.map

package/dist/types/retrieval-session.test.d.ts.map

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

package/dist/types/retrieval-session.test.js

@@ -0,0 +1,17 @@
+import { describe, expect, it } from 'vitest';
+import { RETRIEVAL_MAX_CYCLES } from '../index.js';
+describe('retrieval session contract', () => {
+    it('keeps the retrieval envelope optional and bounded', () => {
+        const gap = {
+            kind: 'caller', reason: 'missing caller', evidence: ['target selected'],
+            resolver: 'codegraph', priority: 80,
+        };
+        const retrieval = {
+            sessionId: 'r1', cycle: 1, maxCycles: RETRIEVAL_MAX_CYCLES,
+            state: 'open', gaps: [gap], remainingTokenBudget: 500, baselineReceipt: 'hash',
+        };
+        expect(retrieval.maxCycles).toBe(3);
+        expect(retrieval.gaps[0]?.kind).toBe('caller');
+    });
+});
+//# sourceMappingURL=retrieval-session.test.js.map

package/dist/types/retrieval-session.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval-session.test.js","sourceRoot":"","sources":["../../src/types/retrieval-session.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAA+C,MAAM,aAAa,CAAC;AAEhG,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,GAAG,GAAiB;YACxB,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC,iBAAiB,CAAC;YACvE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE;SACpC,CAAC;QACF,MAAM,SAAS,GAAkD;YAC/D,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,oBAAoB;YAC1D,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,oBAAoB,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM;SAC/E,CAAC;QACF,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/types/task-context-envelope.d.ts

@@ -92,5 +92,14 @@ export interface TaskContextEnvelope {
         expiresAt: number;
         hash: string;
     };
+    retrieval?: {
+        sessionId: string;
+        cycle: number;
+        maxCycles: 3;
+        state: 'open' | 'satisfied' | 'exhausted' | 'expired';
+        gaps: import('./retrieval-session.js').RetrievalGap[];
+        remainingTokenBudget: number;
+        baselineReceipt: string;
+    };
 }
 //# sourceMappingURL=task-context-envelope.d.ts.map

package/dist/types/task-context-envelope.d.ts.map

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

package/dist/types/workflow.d.ts

@@ -48,6 +48,7 @@ export interface WorkflowRun {
     failureCategory: FailureCategory | null;
     failureReason?: string;
     failureEvidence?: Record<string, unknown>;
+    metadata?: WorkflowRunMetadata;
 }
 export interface WorkflowStepResult {
     stepId: string;
@@ -56,6 +57,28 @@ export interface WorkflowStepResult {
     output?: unknown;
     duration?: number;
     error?: string;
+    metadata?: WorkflowStepMetadata;
+}
+export type CanonicalWorkflowRunStatus = "running" | "waiting_host" | "completed" | "failed" | "canceled";
+export type CanonicalWorkflowStepStatus = "pending" | "running" | "waiting_host" | "verifying" | "success" | "failed" | "skipped" | "awaiting_approval";
+export interface WorkflowStepMetadata {
+    canonicalStatus: CanonicalWorkflowStepStatus;
+    actionId?: string;
+    actionKind?: "execute" | "verify";
+    actionIds?: string[];
+    verifiedActionIds?: string[];
+    evidenceHash?: string;
+    shadowCandidate?: Record<string, unknown>;
+}
+export interface WorkflowRunMetadata {
+    canonicalStatus: CanonicalWorkflowRunStatus;
+    engineRunId: string;
+    telemetryRunId: string;
+    projectRoot: string;
+    sessionId: string;
+    executionId?: string;
+    contextReceipt?: string;
+    actionIds?: string[];
 }
 export interface WorkflowRunResult {
     runId: string;
@@ -63,6 +86,7 @@ export interface WorkflowRunResult {
     duration: number;
     failureCategory: FailureCategory | null;
     failureReason?: string;
+    metadata?: WorkflowRunMetadata;
 }
 export interface WorkflowRejection {
     reason: string;

package/dist/types/workflow.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/sdk",
-  "version": "0.16.18",
+  "version": "0.16.20",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -21,6 +21,10 @@
       "import": "./dist/plugin-workflow.js",
       "types": "./dist/plugin-workflow.d.ts"
     },
+    "./capability-rollout": {
+      "import": "./dist/capability-rollout.js",
+      "types": "./dist/capability-rollout.d.ts"
+    },
     "./utils/project-scanner": {
       "import": "./dist/utils/project-scanner.js",
       "types": "./dist/utils/project-scanner.d.ts"
@@ -33,7 +37,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@devflow-tools/database": "0.16.18",
+    "@devflow-tools/database": "0.16.20",
     "tiktoken": "^1.0.0"
   },
   "devDependencies": {