@deftai/directive 0.119.11 → 0.119.12

package/dist/occupancy-release.d.ts

@@ -1,7 +1,17 @@
 #!/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).
+ */
+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;

package/dist/occupancy-release.js

@@ -2,11 +2,38 @@
 import { resolve } from "node:path";
 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).
+ */
+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.";
+export function formatOccupancyReleaseHelp() {
+    return [
+        "Usage: deft occupancy:release [--project-root <path>] [--session-id <id>]",
+        "",
+        "Release this worktree occupancy lease (owner live, or expired residue).",
+        "",
+        ABANDONED_OCCUPANCY_LEASE_RECOVERY,
+        "",
+    ].join("\n");
+}
 export function parseArgs(argv) {
-    const parsed = { projectRoot: "." };
+    const parsed = {
+        projectRoot: ".",
+    };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
-        if (arg === "--project-root") {
+        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" };
@@ -52,6 +79,10 @@ export function run(argv) {
         process.stderr.write(`occupancy:release: ${args.error}\n`);
         return 2;
     }
+    if (args.help === true) {
+        process.stdout.write(formatOccupancyReleaseHelp());
+        return 0;
+    }
     const result = releaseOccupancy(resolve(args.projectRoot), {
         sessionId: args.sessionId,
         env: process.env,

package/dist/verify-ac.js

@@ -12,7 +12,7 @@ import { join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { resolveSessionCompletedVerifyAcTarget } from "@deftai/directive-core/check";
 import { formatRejectedLedger, resolveLiteralAcceptanceDetailed, } from "@deftai/directive-core/literal-acceptance";
-import { emitVerifyAcTerminalOutcome, evaluateVerifyAcFromPath, readAdmittedSourceDigest, readAdmittedSourceSentences, readPlanAcceptance, resolveAcceptanceGateProfile, } from "@deftai/directive-core/product-first-done-gate";
+import { emitVerifyAcTerminalOutcome, evaluateVerifyAcFromPath, readAdmittedSourceDigest, readAdmittedSourceSentences, readPlanAcceptance, resolveAcceptanceGateProfile, resolveSoftMissingAcTargets, } from "@deftai/directive-core/product-first-done-gate";
 /** Parse verify:ac CLI args. */
 export function parseArgs(argv) {
     const parsed = {
@@ -277,18 +277,44 @@ export function run(argv) {
             paths = [found.path];
         }
         else if (found.kind === "many") {
-            // Greptile #3284: multi-active must verify EVERY active scope, not skip.
-            if (args.softMissingXbrief || args.captureOnly) {
+            // #4285: soft-missing selects via DEFT_ACTIVE_SCOPE / explicit path
+            // (or fail closed). ALL-paths soft-missing is not the #3284 product bar.
+            // --capture-only still lists every active artifact (inventory, not run).
+            if (args.captureOnly) {
                 paths = [...found.paths];
                 if (!args.quiet) {
-                    process.stdout.write(`verify:ac multi-active (#3284): evaluating ${paths.length} scopes in ${found.dir}\n`);
+                    process.stdout.write(`verify:ac capture-only multi-active: listing ${paths.length} scopes in ${found.dir}\n`);
+                }
+            }
+            else if (args.softMissingXbrief) {
+                const selected = resolveSoftMissingAcTargets(projectRoot, {
+                    env: process.env,
+                    scannedPaths: found.paths,
+                });
+                if (selected.kind === "one") {
+                    paths = [selected.path];
+                    if (!args.quiet) {
+                        process.stdout.write(`verify:ac soft-missing multi-active (#4285): selected ${selected.path}\n`);
+                    }
+                }
+                else {
+                    process.stderr.write(`${selected.kind === "need-pin" ? selected.message : "verify_ac: multi-active soft-missing needs a pin"}\n` +
+                        "  Usage: task verify:ac -- <path-to-active.xbrief.json>\n" +
+                        `  Or set DEFT_ACTIVE_SCOPE to the dispatched story under ${found.dir}\n` +
+                        "  Refs #4285 / #3284 product-first done-gate\n");
+                    emitVerifyAcTerminalOutcome({
+                        projectRoot,
+                        env: process.env,
+                        outcome: "config-error",
+                    });
+                    return 1;
                 }
             }
             else {
                 process.stderr.write(`verify_ac: ${found.paths.length} active scopes in ${found.dir}.\n` +
-                    "  Pass an explicit path, or use check composition (--soft-missing-xbrief) to evaluate all.\n" +
+                    "  Pass an explicit path, or set DEFT_ACTIVE_SCOPE with check composition (--soft-missing-xbrief).\n" +
                     "  Usage: task verify:ac -- <path-to-active.xbrief.json>\n" +
-                    "  Refs #3284 product-first done-gate\n");
+                    "  Refs #4285 / #3284 product-first done-gate\n");
                 emitVerifyAcTerminalOutcome({
                     projectRoot,
                     env: process.env,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive",
-  "version": "0.119.11",
+  "version": "0.119.12",
   "description": "Directive CLI — npm install path for the Deft Directive framework.",
   "license": "MIT",
   "homepage": "https://deftai.github.io/directive/",
@@ -35,8 +35,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-core": "^0.119.11",
-    "@deftai/directive-content": "^0.119.11"
+    "@deftai/directive-core": "^0.119.12",
+    "@deftai/directive-content": "^0.119.12"
   },
   "scripts": {
     "build": "tsc -b",