@deftai/directive 0.125.1 → 0.126.0-beta.1

package/dist/session-start.js

@@ -1,554 +0,0 @@
-#!/usr/bin/env node
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { CEREMONY_DEPTHS, normalizeCeremonyModelTier, normalizeCeremonyProjectShape, normalizeCeremonyTaskSize, selectCeremonyDepth, } from "@deftai/directive-core/policy";
-import { COLD_CEREMONY_TIER, PRIMARY_CLAIM_EXCEPTIONS, parseDeferrals, parseSessionPostureToken, READ_ONLY_POSTURE, REARM_CEREMONY_TIER, REQUIREMENTS_POSTURE, resolveProductionHostEffortDescriptor, ritualStatePath, runSessionStart, SESSION_CEREMONY_TIERS, } from "@deftai/directive-core/session";
-function parseCeremonyDepth(raw) {
-    const value = raw.trim().toLowerCase();
-    if (CEREMONY_DEPTHS.includes(value)) {
-        return value;
-    }
-    return null;
-}
-function parseCeremonyTier(raw) {
-    const value = raw.trim().toLowerCase();
-    if (SESSION_CEREMONY_TIERS.includes(value)) {
-        return value;
-    }
-    return null;
-}
-const PRIMARY_CLAIM_EXCEPTION_HELP = PRIMARY_CLAIM_EXCEPTIONS.join("|");
-function parsePrimaryClaimException(raw) {
-    const value = raw.trim();
-    if (PRIMARY_CLAIM_EXCEPTIONS.includes(value)) {
-        return value;
-    }
-    return null;
-}
-/** Parse session:start CLI args, mirroring scripts/session_start.py. */
-export function parseArgs(argv) {
-    const parsed = {
-        projectRoot: ".",
-        deferValues: [],
-        deferOwedReason: null,
-        emitJson: false,
-        noHistory: false,
-        readOnly: false,
-        withNetwork: false,
-        ceremonyTier: COLD_CEREMONY_TIER,
-        ceremonyDialInputs: {},
-        ceremonyDepthOverride: null,
-        effortBudgetHost: {},
-        compact: false,
-        steal: false,
-        confirm: false,
-        occupant: null,
-        primaryClaimException: null,
-        sessionId: null,
-        posture: null,
-    };
-    const dialInputs = {};
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i];
-        if (arg === "--") {
-            continue;
-        }
-        if (arg === "--json") {
-            parsed.emitJson = true;
-        }
-        else if (arg === "--no-history") {
-            parsed.noHistory = true;
-        }
-        else if (arg === "--read-only") {
-            parsed.readOnly = true;
-        }
-        else if (arg === "--with-network") {
-            parsed.withNetwork = true;
-        }
-        else if (arg === "--rearm") {
-            // #2992: shortcut for --tier=rearm
-            parsed.ceremonyTier = REARM_CEREMONY_TIER;
-        }
-        else if (arg === "--tier") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --tier: expected one argument (cold|rearm)" };
-            }
-            const tier = parseCeremonyTier(value);
-            if (tier === null) {
-                return {
-                    ...parsed,
-                    error: `argument --tier: expected cold|rearm, got ${JSON.stringify(value)}`,
-                };
-            }
-            parsed.ceremonyTier = tier;
-            i += 1;
-        }
-        else if (arg?.startsWith("--tier=")) {
-            const value = arg.slice("--tier=".length);
-            const tier = parseCeremonyTier(value);
-            if (tier === null) {
-                return {
-                    ...parsed,
-                    error: `argument --tier: expected cold|rearm, got ${JSON.stringify(value)}`,
-                };
-            }
-            parsed.ceremonyTier = tier;
-        }
-        else if (arg === "--project-root") {
-            const value = argv[i + 1];
-            if (value === undefined || value.startsWith("--")) {
-                return { ...parsed, error: "argument --project-root: expected one argument" };
-            }
-            parsed.projectRoot = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--project-root=")) {
-            const value = arg.slice("--project-root=".length);
-            if (value.length === 0 || value.startsWith("--")) {
-                return { ...parsed, error: "argument --project-root: expected one argument" };
-            }
-            parsed.projectRoot = value;
-        }
-        else if (arg === "--defer") {
-            const value = argv[i + 1];
-            if (value === undefined || value.startsWith("--")) {
-                return { ...parsed, error: "argument --defer: expected one argument" };
-            }
-            parsed.deferValues.push(value);
-            i += 1;
-        }
-        else if (arg?.startsWith("--defer=")) {
-            const value = arg.slice("--defer=".length);
-            if (value.length === 0 || value.startsWith("--")) {
-                return { ...parsed, error: "argument --defer: expected one argument" };
-            }
-            parsed.deferValues.push(value);
-        }
-        else if (arg === "--defer-owed") {
-            const value = argv[i + 1];
-            if (value === undefined || value.startsWith("--")) {
-                return { ...parsed, error: "argument --defer-owed: expected one argument" };
-            }
-            parsed.deferOwedReason = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--defer-owed=")) {
-            const value = arg.slice("--defer-owed=".length);
-            if (value.length === 0 || value.startsWith("--")) {
-                return { ...parsed, error: "argument --defer-owed: expected one argument" };
-            }
-            parsed.deferOwedReason = value;
-        }
-        else if (arg === "--task-size" || arg === "--ceremony-task-size") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: `argument ${arg}: expected one argument (S|M|L|XL)` };
-            }
-            const size = normalizeCeremonyTaskSize(value);
-            if (size === null) {
-                return {
-                    ...parsed,
-                    error: `argument ${arg}: expected S|M|L|XL (or small|medium|large), got ${JSON.stringify(value)}`,
-                };
-            }
-            dialInputs.taskSize = size;
-            i += 1;
-        }
-        else if (arg?.startsWith("--task-size=") || arg?.startsWith("--ceremony-task-size=")) {
-            const value = arg.slice(arg.indexOf("=") + 1);
-            const size = normalizeCeremonyTaskSize(value);
-            if (size === null) {
-                return {
-                    ...parsed,
-                    error: `argument --task-size: expected S|M|L|XL, got ${JSON.stringify(value)}`,
-                };
-            }
-            dialInputs.taskSize = size;
-        }
-        else if (arg === "--model-tier" || arg === "--ceremony-model-tier") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return {
-                    ...parsed,
-                    error: `argument ${arg}: expected one argument (frontier|mid|low)`,
-                };
-            }
-            const tier = normalizeCeremonyModelTier(value);
-            if (tier === null) {
-                return {
-                    ...parsed,
-                    error: `argument ${arg}: expected frontier|mid|low, got ${JSON.stringify(value)}`,
-                };
-            }
-            dialInputs.modelTier = tier;
-            i += 1;
-        }
-        else if (arg?.startsWith("--model-tier=") || arg?.startsWith("--ceremony-model-tier=")) {
-            const value = arg.slice(arg.indexOf("=") + 1);
-            const tier = normalizeCeremonyModelTier(value);
-            if (tier === null) {
-                return {
-                    ...parsed,
-                    error: `argument --model-tier: expected frontier|mid|low, got ${JSON.stringify(value)}`,
-                };
-            }
-            dialInputs.modelTier = tier;
-        }
-        else if (arg === "--project-shape" || arg === "--ceremony-project-shape") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return {
-                    ...parsed,
-                    error: `argument ${arg}: expected one argument (project|non-project)`,
-                };
-            }
-            const shape = normalizeCeremonyProjectShape(value);
-            if (shape === null) {
-                return {
-                    ...parsed,
-                    error: `argument ${arg}: expected project|non-project, got ${JSON.stringify(value)}`,
-                };
-            }
-            dialInputs.projectShape = shape;
-            i += 1;
-        }
-        else if (arg?.startsWith("--project-shape=") ||
-            arg?.startsWith("--ceremony-project-shape=")) {
-            const value = arg.slice(arg.indexOf("=") + 1);
-            const shape = normalizeCeremonyProjectShape(value);
-            if (shape === null) {
-                return {
-                    ...parsed,
-                    error: `argument --project-shape: expected project|non-project, got ${JSON.stringify(value)}`,
-                };
-            }
-            dialInputs.projectShape = shape;
-        }
-        else if (arg === "--ceremony-depth") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return {
-                    ...parsed,
-                    error: "argument --ceremony-depth: expected one argument (minimal|rapid|standard|elevated)",
-                };
-            }
-            const depth = parseCeremonyDepth(value);
-            if (depth === null) {
-                return {
-                    ...parsed,
-                    error: `argument --ceremony-depth: expected minimal|rapid|standard|elevated, got ${JSON.stringify(value)}`,
-                };
-            }
-            parsed.ceremonyDepthOverride = depth;
-            i += 1;
-        }
-        else if (arg?.startsWith("--ceremony-depth=")) {
-            const value = arg.slice("--ceremony-depth=".length);
-            const depth = parseCeremonyDepth(value);
-            if (depth === null) {
-                return {
-                    ...parsed,
-                    error: `argument --ceremony-depth: expected minimal|rapid|standard|elevated, got ${JSON.stringify(value)}`,
-                };
-            }
-            parsed.ceremonyDepthOverride = depth;
-        }
-        else if (arg === "--max-turns") {
-            // #3266: harness hard turn budget for bank-the-pass guidance
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --max-turns: expected one argument" };
-            }
-            const n = Number(value);
-            if (!Number.isFinite(n) || n < 0) {
-                return {
-                    ...parsed,
-                    error: `argument --max-turns: expected non-negative number, got ${JSON.stringify(value)}`,
-                };
-            }
-            parsed.effortBudgetHost.maxTurns = n;
-            i += 1;
-        }
-        else if (arg?.startsWith("--max-turns=")) {
-            const value = arg.slice("--max-turns=".length);
-            const n = Number(value);
-            if (!Number.isFinite(n) || n < 0) {
-                return {
-                    ...parsed,
-                    error: `argument --max-turns: expected non-negative number, got ${JSON.stringify(value)}`,
-                };
-            }
-            parsed.effortBudgetHost.maxTurns = n;
-        }
-        else if (arg === "--max-budget") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --max-budget: expected one argument" };
-            }
-            const n = Number(value);
-            if (!Number.isFinite(n) || n < 0) {
-                return {
-                    ...parsed,
-                    error: `argument --max-budget: expected non-negative number, got ${JSON.stringify(value)}`,
-                };
-            }
-            parsed.effortBudgetHost.maxBudget = n;
-            i += 1;
-        }
-        else if (arg?.startsWith("--max-budget=")) {
-            const value = arg.slice("--max-budget=".length);
-            const n = Number(value);
-            if (!Number.isFinite(n) || n < 0) {
-                return {
-                    ...parsed,
-                    error: `argument --max-budget: expected non-negative number, got ${JSON.stringify(value)}`,
-                };
-            }
-            parsed.effortBudgetHost.maxBudget = n;
-        }
-        else if (arg === "--hard-budget") {
-            parsed.effortBudgetHost.hardBudget = true;
-        }
-        else if (arg === "--compact") {
-            // #3286: terse machine orientation output (opt-in; verbose remains default)
-            parsed.compact = true;
-        }
-        else if (arg === "--steal") {
-            parsed.steal = true;
-        }
-        else if (arg === "--primary-claim-exception") {
-            const value = argv[i + 1];
-            if (value === undefined || value.startsWith("--")) {
-                return {
-                    ...parsed,
-                    error: `argument --primary-claim-exception: expected one argument (${PRIMARY_CLAIM_EXCEPTION_HELP})`,
-                };
-            }
-            const exception = parsePrimaryClaimException(value);
-            if (exception === null) {
-                return {
-                    ...parsed,
-                    error: `argument --primary-claim-exception: expected ${PRIMARY_CLAIM_EXCEPTION_HELP}, got ${JSON.stringify(value)}`,
-                };
-            }
-            parsed.primaryClaimException = exception;
-            i += 1;
-        }
-        else if (arg?.startsWith("--primary-claim-exception=")) {
-            const value = arg.slice("--primary-claim-exception=".length);
-            if (value.length === 0 || value.startsWith("--")) {
-                return {
-                    ...parsed,
-                    error: `argument --primary-claim-exception: expected one argument (${PRIMARY_CLAIM_EXCEPTION_HELP})`,
-                };
-            }
-            const exception = parsePrimaryClaimException(value);
-            if (exception === null) {
-                return {
-                    ...parsed,
-                    error: `argument --primary-claim-exception: expected ${PRIMARY_CLAIM_EXCEPTION_HELP}, got ${JSON.stringify(value)}`,
-                };
-            }
-            parsed.primaryClaimException = exception;
-        }
-        else if (arg === "--confirm") {
-            parsed.confirm = true;
-        }
-        else if (arg === "--session-id") {
-            const value = argv[i + 1];
-            if (value === undefined || value.startsWith("--")) {
-                return { ...parsed, error: "argument --session-id: expected one argument" };
-            }
-            const sessionId = value.trim();
-            if (sessionId.length === 0 || sessionId.startsWith("--")) {
-                return { ...parsed, error: "argument --session-id: expected a non-empty value" };
-            }
-            parsed.sessionId = sessionId;
-            i += 1;
-        }
-        else if (arg?.startsWith("--session-id=")) {
-            const sessionId = arg.slice("--session-id=".length).trim();
-            if (sessionId.length === 0 || sessionId.startsWith("--")) {
-                return { ...parsed, error: "argument --session-id: expected a non-empty value" };
-            }
-            parsed.sessionId = sessionId;
-        }
-        else if (arg === "--occupant") {
-            const value = argv[i + 1];
-            if (value === undefined || value.startsWith("--")) {
-                return { ...parsed, error: "argument --occupant: expected one argument" };
-            }
-            parsed.occupant = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--occupant=")) {
-            const value = arg.slice("--occupant=".length);
-            if (value.length === 0 || value.startsWith("--")) {
-                return { ...parsed, error: "argument --occupant: expected one argument" };
-            }
-            parsed.occupant = value;
-        }
-        else if (arg === "--posture") {
-            const value = argv[i + 1];
-            if (value === undefined || value.startsWith("--")) {
-                return {
-                    ...parsed,
-                    error: "argument --posture: expected one argument (read-only|mutation|requirements)",
-                };
-            }
-            const parsedPosture = parseSessionPostureToken(value);
-            if (parsedPosture.error !== null) {
-                return { ...parsed, error: parsedPosture.error };
-            }
-            if (parsedPosture.token === "assist") {
-                return {
-                    ...parsed,
-                    error: "argument --posture=docs|assist is scratch-only; set DEFT_SESSION_POSTURE=assist. Tracked docs use --posture=requirements",
-                };
-            }
-            if (parsedPosture.token === null) {
-                return {
-                    ...parsed,
-                    error: "argument --posture: expected one argument (read-only|mutation|requirements)",
-                };
-            }
-            parsed.posture = parsedPosture.token;
-            i += 1;
-        }
-        else if (arg?.startsWith("--posture=")) {
-            const value = arg.slice("--posture=".length);
-            const parsedPosture = parseSessionPostureToken(value);
-            if (parsedPosture.error !== null) {
-                return { ...parsed, error: parsedPosture.error };
-            }
-            if (parsedPosture.token === "assist") {
-                return {
-                    ...parsed,
-                    error: "argument --posture=docs|assist is scratch-only; set DEFT_SESSION_POSTURE=assist. Tracked docs use --posture=requirements",
-                };
-            }
-            if (parsedPosture.token === null) {
-                return {
-                    ...parsed,
-                    error: "argument --posture: expected one argument (read-only|mutation|requirements)",
-                };
-            }
-            parsed.posture = parsedPosture.token;
-        }
-        else {
-            return { ...parsed, error: `unrecognized argument: ${arg}` };
-        }
-    }
-    parsed.ceremonyDialInputs = {
-        taskSize: dialInputs.taskSize ?? null,
-        modelTier: dialInputs.modelTier ?? null,
-        projectShape: dialInputs.projectShape ?? null,
-    };
-    return parsed;
-}
-/** Native session:start handler (#2032 — replaces framework-commands Python bridge). */
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`session_start: ${args.error}\n`);
-        return 2;
-    }
-    const projectRoot = resolve(args.projectRoot);
-    const { deferrals, errors } = parseDeferrals(args.deferValues);
-    if (errors.length > 0) {
-        for (const error of errors) {
-            process.stderr.write(`${error}\n`);
-        }
-        return 2;
-    }
-    const capturedStdout = [];
-    const prevWrite = process.stdout.write.bind(process.stdout);
-    process.stdout.write = ((chunk, encoding, callback) => {
-        capturedStdout.push(String(chunk));
-        const cb = typeof encoding === "function" ? encoding : callback;
-        if (typeof cb === "function") {
-            cb();
-        }
-        return true;
-    });
-    // #3266: production host adapter — native harness env + DEFT_HOST_EFFORT_BUDGET + CLI flags.
-    const hostDescriptor = {
-        ...resolveProductionHostEffortDescriptor(process.env),
-    };
-    if (args.effortBudgetHost.maxTurns !== undefined) {
-        hostDescriptor.maxTurns = args.effortBudgetHost.maxTurns;
-    }
-    if (args.effortBudgetHost.maxBudget !== undefined) {
-        hostDescriptor.maxBudget = args.effortBudgetHost.maxBudget;
-    }
-    if (args.effortBudgetHost.hardBudget === true) {
-        hostDescriptor.hardBudget = true;
-    }
-    let result;
-    try {
-        // #3214: --ceremony-depth forces this session only (not persisted to policy).
-        result = runSessionStart(projectRoot, {
-            deferrals,
-            writeHistory: !args.noHistory,
-            posture: args.readOnly ? READ_ONLY_POSTURE : (args.posture ?? undefined),
-            allowOptionalNetwork: args.withNetwork ? true : undefined,
-            ceremonyTier: args.ceremonyTier,
-            ceremonyDialInputs: args.ceremonyDialInputs,
-            effortBudgetSeams: { hostDescriptor, environ: process.env },
-            // #3286: --compact flag; DEFT_SESSION_COMPACT still resolved inside core.
-            compact: args.compact ? true : undefined,
-            steal: args.steal ? true : undefined,
-            confirm: args.confirm ? true : undefined,
-            occupant: args.occupant ?? undefined,
-            primaryClaimException: args.primaryClaimException ?? undefined,
-            sessionId: args.sessionId ?? undefined,
-            deferOwedReason: args.deferOwedReason,
-            ...(args.ceremonyDepthOverride !== null
-                ? {
-                    ceremonyDial: selectCeremonyDepth({
-                        config: { enabled: true, override: args.ceremonyDepthOverride },
-                        inputs: args.ceremonyDialInputs,
-                    }),
-                    ceremonyDialStartTierProvenance: "external-pin",
-                }
-                : {}),
-        });
-    }
-    finally {
-        process.stdout.write = prevWrite;
-    }
-    const lines = [...result.lines];
-    const stray = capturedStdout.join("").trim();
-    if (stray) {
-        lines.push(stray);
-    }
-    if (args.emitJson) {
-        const sorted = Object.keys(result.payload)
-            .sort()
-            .reduce((acc, key) => {
-            acc[key] = result.payload[key];
-            return acc;
-        }, {});
-        process.stdout.write(`${JSON.stringify(sorted)}\n`);
-        return result.code;
-    }
-    const sink = result.code === 0 ? process.stdout : process.stderr;
-    for (const line of lines) {
-        sink.write(`${line}\n`);
-    }
-    if (result.code === 0) {
-        const posture = result.payload.posture;
-        if (posture === READ_ONLY_POSTURE || posture === REQUIREMENTS_POSTURE) {
-            process.stdout.write(`[deft] ${String(result.payload.message)}\n`);
-        }
-        else {
-            process.stdout.write(`[deft] session ritual recorded at ${ritualStatePath(projectRoot)} (diagnostic-only; not posture authority)\n`);
-        }
-    }
-    return result.code;
-}
-if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
-    process.exit(run(process.argv.slice(2)));
-}
-//# sourceMappingURL=session-start.js.map

package/dist/slice.d.ts

@@ -1,4 +0,0 @@
-#!/usr/bin/env node
-/** Run slice verbs with argv; returns process exit code. */
-export declare function run(argv: string[]): number;
-//# sourceMappingURL=slice.d.ts.map

package/dist/slice.js

@@ -1,34 +0,0 @@
-#!/usr/bin/env node
-/**
- * Thin CLI entry for slice:record-existing / slice:list (#1727).
- * Delegates to the core implementation at packages/core/dist/slice/cli.js.
- */
-import { spawnSync } from "node:child_process";
-import { createRequire } from "node:module";
-import { fileURLToPath } from "node:url";
-const require = createRequire(import.meta.url);
-// Resolve the core CLI by its published package name so it works both in the
-// source monorepo and under a flattened npm install (#1993). The bare specifier
-// resolves via @deftai/directive-core's "./dist/*.js" export map; a hand-built
-// relative path would point at the non-existent "@deftai/core" once published.
-function coreCliPath() {
-    return require.resolve("@deftai/directive-core/dist/slice/cli.js");
-}
-/** Run slice verbs with argv; returns process exit code. */
-export function run(argv) {
-    const result = spawnSync(process.execPath, [coreCliPath(), ...argv], {
-        encoding: "utf8",
-        stdio: ["ignore", "pipe", "pipe"],
-    });
-    if (typeof result.stdout === "string" && result.stdout.length > 0) {
-        process.stdout.write(result.stdout);
-    }
-    if (typeof result.stderr === "string" && result.stderr.length > 0) {
-        process.stderr.write(result.stderr);
-    }
-    return result.status ?? 2;
-}
-if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
-    process.exit(run(process.argv.slice(2)));
-}
-//# sourceMappingURL=slice.js.map

package/dist/story-ready-fixtures.d.ts

@@ -1,47 +0,0 @@
-export interface ScenarioResult {
-    readonly name: string;
-    readonly exitCode: number;
-    readonly stdout: string;
-    readonly stderr: string;
-}
-export interface ParityScenario {
-    readonly name: string;
-    readonly vbriefRel: string;
-    readonly vbriefStatus?: string;
-    readonly envelopeRel: string | null;
-    readonly allowDirty?: boolean;
-    readonly dirty?: boolean;
-}
-export interface ParityResult {
-    readonly ok: boolean;
-    readonly scenarios: Array<{
-        readonly name: string;
-        readonly exitMismatch: boolean;
-        readonly pythonExit: number;
-        readonly tsExit: number;
-        readonly messageMismatch: boolean;
-        readonly pythonMessage: string;
-        readonly tsMessage: string;
-    }>;
-}
-/** Scenarios exercised by the parity harness (mirrors Python contract cases). */
-export declare const PARITY_SCENARIOS: readonly ParityScenario[];
-/** Normalise gate message for comparison (trim, collapse whitespace). */
-export declare function normaliseMessage(stdout: string, stderr: string, exitCode: number): string;
-/** Build a fixture repo for one scenario; return repo root + vbrief absolute path. */
-export declare function buildScenarioRepo(scenario: ParityScenario): {
-    root: string;
-    vbriefPath: string;
-    envelopePath: string | null;
-};
-/** Diff python vs TS gate outputs across all parity scenarios. */
-export declare function diffParity(python: ScenarioResult, ts: ScenarioResult): {
-    exitMismatch: boolean;
-    messageMismatch: boolean;
-    pythonMessage: string;
-    tsMessage: string;
-};
-/** Run all parity scenarios and return a structured result. */
-/** Render a human-readable parity report (exported for unit tests). */
-export declare function renderReport(result: ParityResult): string;
-//# sourceMappingURL=story-ready-fixtures.d.ts.map