@deftai/directive 0.126.2 → 0.128.0

package/dist/migrate-category-b.js

@@ -1,52 +0,0 @@
-#!/usr/bin/env node
-import { fileURLToPath } from "node:url";
-import { migrateCategoryBCorpus } from "@deftai/directive-core/category-b-namespace";
-export function parseArgs(argv) {
-    let projectRoot = ".";
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i] ?? "";
-        if (arg === "--project-root") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { projectRoot, error: "argument --project-root: expected one argument" };
-            }
-            projectRoot = value;
-            i += 1;
-        }
-        else if (arg.startsWith("--project-root=")) {
-            projectRoot = arg.slice("--project-root=".length);
-        }
-        else {
-            return { projectRoot, error: `unrecognized argument: ${arg}` };
-        }
-    }
-    return { projectRoot };
-}
-/** Migrate Category B bare plan keys to the x-directive/ namespace (#1650). */
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`migrate:category-b: ${args.error}\n`);
-        return 2;
-    }
-    const result = migrateCategoryBCorpus(args.projectRoot);
-    if (result.conflicts.length > 0) {
-        for (const conflict of result.conflicts) {
-            process.stderr.write(`migrate:category-b: conflict in ${conflict.path}: ${conflict.message}\n`);
-        }
-        return 1;
-    }
-    if (result.changed.length === 0) {
-        process.stdout.write(`migrate:category-b: ${result.scanned} vBRIEF file(s) scanned -- already namespaced.\n`);
-        return 0;
-    }
-    process.stdout.write(`migrate:category-b: namespaced ${result.changed.length} of ${result.scanned} vBRIEF file(s):\n`);
-    for (const path of result.changed) {
-        process.stdout.write(`  ${path}\n`);
-    }
-    return 0;
-}
-if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
-    process.exit(run(process.argv.slice(2)));
-}
-//# sourceMappingURL=migrate-category-b.js.map

package/dist/migrate-preflight.d.ts

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-export interface ParsedMigratePreflightArgs {
-    projectRoot: string;
-    deftRoot: string;
-    quiet: boolean;
-    error?: string;
-}
-export declare function parseArgs(argv: readonly string[]): ParsedMigratePreflightArgs;
-export declare function run(argv: readonly string[]): number;
-//# sourceMappingURL=migrate-preflight.d.ts.map

package/dist/migrate-preflight.js

@@ -1,85 +0,0 @@
-#!/usr/bin/env node
-import { fileURLToPath } from "node:url";
-import { resolveFrameworkRootForProject } from "@deftai/directive-core/doctor";
-import { emitMigratePreflight, runMigratePreflight, } from "@deftai/directive-core/migrate-preflight";
-export function parseArgs(argv) {
-    let projectRoot = ".";
-    let explicitDeftRoot;
-    let quiet = false;
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i] ?? "";
-        if (arg === "--quiet") {
-            quiet = true;
-        }
-        else if (arg === "--project-root") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return {
-                    projectRoot,
-                    deftRoot: resolveFrameworkRootForProject(projectRoot, explicitDeftRoot),
-                    quiet,
-                    error: "argument --project-root: expected one argument",
-                };
-            }
-            projectRoot = value;
-            i += 1;
-        }
-        else if (arg.startsWith("--project-root=")) {
-            projectRoot = arg.slice("--project-root=".length);
-        }
-        else if (arg === "--deft-root") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return {
-                    projectRoot,
-                    deftRoot: resolveFrameworkRootForProject(projectRoot, explicitDeftRoot),
-                    quiet,
-                    error: "argument --deft-root: expected one argument",
-                };
-            }
-            explicitDeftRoot = value;
-            i += 1;
-        }
-        else if (arg.startsWith("--deft-root=")) {
-            explicitDeftRoot = arg.slice("--deft-root=".length);
-        }
-        else {
-            return {
-                projectRoot,
-                deftRoot: resolveFrameworkRootForProject(projectRoot, explicitDeftRoot),
-                quiet,
-                error: `unrecognized argument: ${arg}`,
-            };
-        }
-    }
-    const deftRoot = resolveFrameworkRootForProject(projectRoot, explicitDeftRoot);
-    return { projectRoot, deftRoot, quiet };
-}
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`migrate-preflight: ${args.error}\n`);
-        return 2;
-    }
-    const outcome = runMigratePreflight({
-        projectRoot: args.projectRoot,
-        deftRoot: args.deftRoot,
-        quiet: args.quiet,
-    });
-    if (outcome.kind === "config") {
-        process.stderr.write(`migrate-preflight: ${outcome.message}\n`);
-        return 2;
-    }
-    return emitMigratePreflight(outcome, {
-        writeOut: (text) => {
-            process.stdout.write(text);
-        },
-        writeErr: (text) => {
-            process.stderr.write(text);
-        },
-    }, args.quiet);
-}
-if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
-    process.exit(run(process.argv.slice(2)));
-}
-//# sourceMappingURL=migrate-preflight.js.map

package/dist/migrate-xbrief.d.ts

@@ -1,11 +0,0 @@
-#!/usr/bin/env node
-export interface ParsedMigrateXbriefArgs {
-    projectRoot: string;
-    frameworkRoot: string;
-    force: boolean;
-    keepLegacy: boolean;
-    error?: string;
-}
-export declare function parseArgs(argv: readonly string[]): ParsedMigrateXbriefArgs;
-export declare function run(argv: readonly string[]): number;
-//# sourceMappingURL=migrate-xbrief.d.ts.map

package/dist/migrate-xbrief.js

@@ -1,88 +0,0 @@
-#!/usr/bin/env node
-import { fileURLToPath } from "node:url";
-import { resolveFrameworkRootForProject } from "@deftai/directive-core/doctor";
-import { runXbriefMigrationCli } from "@deftai/directive-core/xbrief-migrate";
-export function parseArgs(argv) {
-    let projectRoot = ".";
-    let explicitFrameworkRoot;
-    let force = false;
-    let keepLegacy = false;
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i] ?? "";
-        if (arg === "--force") {
-            force = true;
-        }
-        else if (arg === "--keep-legacy") {
-            keepLegacy = true;
-        }
-        else if (arg === "--project-root") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return {
-                    projectRoot,
-                    frameworkRoot: resolveFrameworkRootForProject(projectRoot, explicitFrameworkRoot),
-                    force,
-                    keepLegacy,
-                    error: "argument --project-root: expected one argument",
-                };
-            }
-            projectRoot = value;
-            i += 1;
-        }
-        else if (arg.startsWith("--project-root=")) {
-            projectRoot = arg.slice("--project-root=".length);
-        }
-        else if (arg === "--framework-root") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return {
-                    projectRoot,
-                    frameworkRoot: resolveFrameworkRootForProject(projectRoot, explicitFrameworkRoot),
-                    force,
-                    keepLegacy,
-                    error: "argument --framework-root: expected one argument",
-                };
-            }
-            explicitFrameworkRoot = value;
-            i += 1;
-        }
-        else if (arg.startsWith("--framework-root=")) {
-            explicitFrameworkRoot = arg.slice("--framework-root=".length);
-        }
-        else {
-            return {
-                projectRoot,
-                frameworkRoot: resolveFrameworkRootForProject(projectRoot, explicitFrameworkRoot),
-                force,
-                keepLegacy,
-                error: `unrecognized argument: ${arg}`,
-            };
-        }
-    }
-    const frameworkRoot = resolveFrameworkRootForProject(projectRoot, explicitFrameworkRoot);
-    return { projectRoot, frameworkRoot, force, keepLegacy };
-}
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`migrate:xbrief: ${args.error}\n`);
-        return 2;
-    }
-    return runXbriefMigrationCli({
-        projectRoot: args.projectRoot,
-        frameworkRoot: args.frameworkRoot,
-        force: args.force,
-        keepLegacy: args.keepLegacy,
-    }, {
-        writeOut: (text) => {
-            process.stdout.write(text);
-        },
-        writeErr: (text) => {
-            process.stderr.write(text);
-        },
-    });
-}
-if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
-    process.exit(run(process.argv.slice(2)));
-}
-//# sourceMappingURL=migrate-xbrief.js.map

package/dist/occupancy-grant.d.ts

@@ -1,18 +0,0 @@
-#!/usr/bin/env node
-import { type OccupancyJoinProtocol } from "@deftai/directive-core/session";
-export interface GrantArgs {
-    projectRoot: string;
-    sessionId?: string;
-    childSessionId?: string;
-    role?: string;
-    worktree?: string;
-    ttlMinutes?: number;
-    host?: string;
-    address?: string;
-    joinProtocol?: OccupancyJoinProtocol;
-    revoke: boolean;
-    error?: string;
-}
-export declare function parseArgs(argv: readonly string[]): GrantArgs;
-export declare function run(argv: readonly string[]): number;
-//# sourceMappingURL=occupancy-grant.d.ts.map

package/dist/occupancy-grant.js

@@ -1,121 +0,0 @@
-#!/usr/bin/env node
-import { resolve } from "node:path";
-import { grantOccupancyMembership, OCCUPANCY_JOIN_PROTOCOLS, revokeOccupancyMembership, } from "@deftai/directive-core/session";
-import { occupancyUnrecognizedArgument } from "./occupancy-unrecognized.js";
-const VALUE_FLAGS = [
-    "--project-root",
-    "--session-id",
-    "--child-session-id",
-    "--role",
-    "--worktree",
-    "--ttl-minutes",
-    "--host",
-    "--address",
-    "--join-protocol",
-];
-function readValue(argv, index, flag) {
-    const arg = argv[index] ?? "";
-    const inline = `${flag}=`;
-    const raw = arg.startsWith(inline) ? arg.slice(inline.length) : argv[index + 1];
-    if (raw === undefined || raw.startsWith("--")) {
-        return { error: `argument ${flag}: expected one argument` };
-    }
-    const value = raw.trim();
-    if (value.length === 0) {
-        return { error: `argument ${flag}: expected a non-empty value` };
-    }
-    return { value, next: arg.startsWith(inline) ? index : index + 1 };
-}
-export function parseArgs(argv) {
-    const parsed = { projectRoot: ".", revoke: false };
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i] ?? "";
-        if (arg === "--revoke")
-            continue;
-        const flag = VALUE_FLAGS.find((name) => arg === name || arg.startsWith(`${name}=`));
-        if (flag === undefined) {
-            return {
-                ...parsed,
-                revoke: argv.includes("--revoke"),
-                error: occupancyUnrecognizedArgument(arg),
-            };
-        }
-        const read = readValue(argv, i, flag);
-        if ("error" in read)
-            return { ...parsed, revoke: argv.includes("--revoke"), error: read.error };
-        i = read.next;
-        switch (flag) {
-            case "--project-root":
-                parsed.projectRoot = read.value;
-                break;
-            case "--session-id":
-                parsed.sessionId = read.value;
-                break;
-            case "--child-session-id":
-                parsed.childSessionId = read.value;
-                break;
-            case "--role":
-                parsed.role = read.value;
-                break;
-            case "--worktree":
-                parsed.worktree = read.value;
-                break;
-            case "--host":
-                parsed.host = read.value;
-                break;
-            case "--address":
-                parsed.address = read.value;
-                break;
-            case "--ttl-minutes": {
-                const minutes = Number(read.value);
-                if (!Number.isFinite(minutes) || minutes <= 0) {
-                    return {
-                        ...parsed,
-                        revoke: argv.includes("--revoke"),
-                        error: "argument --ttl-minutes: expected a positive number of minutes",
-                    };
-                }
-                parsed.ttlMinutes = minutes;
-                break;
-            }
-            case "--join-protocol": {
-                if (!OCCUPANCY_JOIN_PROTOCOLS.includes(read.value)) {
-                    return {
-                        ...parsed,
-                        revoke: argv.includes("--revoke"),
-                        error: `argument --join-protocol: expected one of ${OCCUPANCY_JOIN_PROTOCOLS.join(", ")}`,
-                    };
-                }
-                parsed.joinProtocol = read.value;
-                break;
-            }
-        }
-    }
-    return { ...parsed, revoke: argv.includes("--revoke") };
-}
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`occupancy:grant: ${args.error}\n`);
-        return 2;
-    }
-    const projectRoot = resolve(args.projectRoot);
-    const input = {
-        sessionId: args.sessionId,
-        childSessionId: args.childSessionId,
-        role: args.role,
-        worktreePath: args.worktree,
-        ttlMs: args.ttlMinutes === undefined ? undefined : args.ttlMinutes * 60 * 1000,
-        host: args.host,
-        address: args.address,
-        joinProtocol: args.joinProtocol,
-        env: process.env,
-    };
-    const result = args.revoke
-        ? revokeOccupancyMembership(projectRoot, input)
-        : grantOccupancyMembership(projectRoot, input);
-    const sink = result.code === 0 ? process.stdout : process.stderr;
-    sink.write(`${result.message}\n`);
-    return result.code;
-}
-//# sourceMappingURL=occupancy-grant.js.map

package/dist/occupancy-heartbeat.d.ts

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-export declare function parseArgs(argv: readonly string[]): {
-    projectRoot: string;
-    sessionId?: string;
-    error?: string;
-};
-export declare function run(argv: readonly string[]): number;
-//# sourceMappingURL=occupancy-heartbeat.d.ts.map

package/dist/occupancy-heartbeat.js

@@ -1,63 +0,0 @@
-#!/usr/bin/env node
-import { resolve } from "node:path";
-import { heartbeatOccupancy } from "@deftai/directive-core/session";
-import { occupancyUnrecognizedArgument } from "./occupancy-unrecognized.js";
-export function parseArgs(argv) {
-    const parsed = { projectRoot: "." };
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i];
-        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 === "--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 {
-            return { ...parsed, error: occupancyUnrecognizedArgument(arg) };
-        }
-    }
-    return parsed;
-}
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`occupancy:heartbeat: ${args.error}\n`);
-        return 2;
-    }
-    const result = heartbeatOccupancy(resolve(args.projectRoot), {
-        sessionId: args.sessionId,
-        env: process.env,
-    });
-    const sink = result.code === 0 ? process.stdout : process.stderr;
-    sink.write(`${result.message}\n`);
-    return result.code;
-}
-//# sourceMappingURL=occupancy-heartbeat.js.map

package/dist/occupancy-release.d.ts

@@ -1,23 +0,0 @@
-#!/usr/bin/env node
-/**
- * First-class abandoned-lease recovery (#4667). Live actor is session_id in
- * .deft/occupancy.json; bare session:end with empty identity refuses; TTL
- * claim-over and deny-embedded copy-paste remain. host:none / address:none
- * are unset metadata, not the lock cause. Does not reopen anonymous live
- * auto-release (#3954).
- *
- * #5544 Prefer-A: pass the supplied --project-root through to releaseOccupancy
- * so the consumer AGENTS.md header check stays at the project directory.
- * Lease file / lock resolution stays inside releaseOccupancy (shared with the
- * Write-hook lease view); denials / already-free print occupancyFile=.
- */
-export declare const ABANDONED_OCCUPANCY_LEASE_RECOVERY: string;
-export declare function formatOccupancyReleaseHelp(): string;
-export declare function parseArgs(argv: readonly string[]): {
-    projectRoot: string;
-    sessionId?: string;
-    help?: boolean;
-    error?: string;
-};
-export declare function run(argv: readonly string[]): number;
-//# sourceMappingURL=occupancy-release.d.ts.map

package/dist/occupancy-release.js

@@ -1,102 +0,0 @@
-#!/usr/bin/env node
-import { releaseOccupancy } from "@deftai/directive-core/session";
-import { occupancyUnrecognizedArgument } from "./occupancy-unrecognized.js";
-/**
- * First-class abandoned-lease recovery (#4667). Live actor is session_id in
- * .deft/occupancy.json; bare session:end with empty identity refuses; TTL
- * claim-over and deny-embedded copy-paste remain. host:none / address:none
- * are unset metadata, not the lock cause. Does not reopen anonymous live
- * auto-release (#3954).
- *
- * #5544 Prefer-A: pass the supplied --project-root through to releaseOccupancy
- * so the consumer AGENTS.md header check stays at the project directory.
- * Lease file / lock resolution stays inside releaseOccupancy (shared with the
- * Write-hook lease view); denials / already-free print occupancyFile=.
- */
-export const ABANDONED_OCCUPANCY_LEASE_RECOVERY = "Abandoned live occupancy lease: bare session:end / occupancy:release without a presented " +
-    "session identity refuses while the lease is live. Immediate recovery: " +
-    "occupancy:release --session-id=<id from .deft/occupancy.json> " +
-    "(read session_id from that file). Or wait for TTL claim-over. " +
-    "host:none / address:none are ordinary unset metadata, not the lock cause. " +
-    "Denials and already-free print occupancyFile= for the lease root this CLI resolved.";
-export function formatOccupancyReleaseHelp() {
-    return [
-        "Usage: deft occupancy:release [--project-root <path>] [--session-id <id>]",
-        "",
-        "Release this worktree occupancy lease (owner live, or expired residue).",
-        "Pass the consumer project directory as --project-root (header check uses it; lease file resolves to the Git toplevel when available).",
-        "",
-        ABANDONED_OCCUPANCY_LEASE_RECOVERY,
-        "",
-    ].join("\n");
-}
-export function parseArgs(argv) {
-    const parsed = {
-        projectRoot: ".",
-    };
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i];
-        if (arg === "--help" || arg === "-h") {
-            parsed.help = true;
-        }
-        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 === "--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 {
-            return { ...parsed, error: occupancyUnrecognizedArgument(arg) };
-        }
-    }
-    return parsed;
-}
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`occupancy:release: ${args.error}\n`);
-        return 2;
-    }
-    if (args.help === true) {
-        process.stdout.write(formatOccupancyReleaseHelp());
-        return 0;
-    }
-    // Keep the supplied project directory for the consumer header check; lease
-    // root resolution happens inside releaseOccupancy (#5544 Greptile P1).
-    const result = releaseOccupancy(args.projectRoot, {
-        sessionId: args.sessionId,
-        env: process.env,
-    });
-    const sink = result.code === 0 ? process.stdout : process.stderr;
-    sink.write(`${result.message}\n`);
-    return result.code;
-}
-//# sourceMappingURL=occupancy-release.js.map

package/dist/occupancy-steal.d.ts

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-export declare function parseArgs(argv: readonly string[]): {
-    projectRoot: string;
-    confirm: boolean;
-    occupant: string | null;
-    sessionId?: string;
-    error?: string;
-};
-export declare function run(argv: readonly string[]): number;
-//# sourceMappingURL=occupancy-steal.d.ts.map