@blxzer/pactile 0.5.0

package/dist/commands/channel/wait.d.ts

@@ -0,0 +1,17 @@
+export interface WaitOptions {
+    as: string;
+    timeoutMs?: number;
+    from?: string;
+    kind?: string;
+    to?: string;
+    scope?: string;
+    thread?: string;
+    action?: string;
+    includeProgress?: boolean;
+    /** Wait until every agent in --from has produced a matching event. */
+    all?: boolean;
+}
+export declare function channelWait(channelName: string, opts: WaitOptions): Promise<void>;
+/** Parse a duration like "30s", "2m", "1h" into milliseconds. */
+export declare function parseDuration(s: string | undefined): number | undefined;
+//# sourceMappingURL=wait.d.ts.map

package/dist/commands/channel/wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../../src/commands/channel/wait.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAID,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,IAAI,CAAC,CAiDf;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAmBvE"}

package/dist/commands/channel/wait.js

@@ -0,0 +1,75 @@
+import { parseChannelKinds } from "./store/events.js";
+import { resolveExistingChannelRef } from "./store/paths.js";
+import { normalizeThreadKey, parseCsv, parseChannelScope, parseThreadAction, } from "./store/schema.js";
+import { watchEvents } from "./store/watch.js";
+const TIMEOUT_EXIT_CODE = 124;
+export async function channelWait(channelName, opts) {
+    const ref = resolveExistingChannelRef(channelName, {
+        scope: parseChannelScope(opts.scope),
+    });
+    const fromList = parseCsv(opts.from);
+    if (opts.all && (!fromList || fromList.length === 0)) {
+        throw new Error("--all requires --from <a,b,...>");
+    }
+    const filter = {
+        self: opts.as,
+        from: fromList,
+        kind: parseChannelKinds(opts.kind),
+        to: opts.to ?? opts.as, // default: broadcasts to me + explicit-to-me
+        thread: opts.thread ? normalizeThreadKey(opts.thread) : undefined,
+        action: opts.action ? parseThreadAction(opts.action) : undefined,
+        includeProgress: opts.includeProgress,
+    };
+    const abort = new AbortController();
+    const timer = opts.timeoutMs
+        ? setTimeout(() => abort.abort(), opts.timeoutMs)
+        : undefined;
+    // --all: wait for one matching event from EACH named agent before returning.
+    // Without --all: return on the first matching event (legacy semantics).
+    const pending = opts.all ? new Set(fromList) : null;
+    try {
+        for await (const ev of watchEvents(channelName, filter, {
+            signal: abort.signal,
+            project: ref.project,
+        })) {
+            console.log(JSON.stringify(ev));
+            if (!pending)
+                return;
+            pending.delete(ev.by);
+            if (pending.size === 0)
+                return;
+        }
+        // Iterator ended without satisfying — timeout
+        if (pending && pending.size > 0) {
+            process.stderr.write(`timeout: still waiting on ${[...pending].join(",")}\n`);
+        }
+        process.exitCode = TIMEOUT_EXIT_CODE;
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+/** Parse a duration like "30s", "2m", "1h" into milliseconds. */
+export function parseDuration(s) {
+    if (!s)
+        return undefined;
+    const m = /^(\d+)(ms|s|m|h)?$/.exec(s.trim());
+    if (!m) {
+        throw new Error(`Invalid duration: ${s} (use Ns / Nm / Nh / Nms)`);
+    }
+    const n = Number(m[1]);
+    switch (m[2] ?? "s") {
+        case "ms":
+            return n;
+        case "s":
+            return n * 1000;
+        case "m":
+            return n * 60_000;
+        case "h":
+            return n * 3_600_000;
+        default:
+            return n * 1000;
+    }
+}
+//# sourceMappingURL=wait.js.map

package/dist/commands/channel/wait.js.map

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

package/dist/commands/detach.d.ts

@@ -0,0 +1,7 @@
+import { type DetachApplyResult, type DetachPlan } from "../pactile/exit/service.js";
+export interface DetachOptions {
+    readonly adapter: string;
+    readonly dryRun?: boolean;
+}
+export declare function detach(options: DetachOptions): DetachPlan | DetachApplyResult;
+//# sourceMappingURL=detach.d.ts.map

package/dist/commands/detach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detach.d.ts","sourceRoot":"","sources":["../../src/commands/detach.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,UAAU,EAChB,MAAM,4BAA4B,CAAC;AAOpC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAOD,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,UAAU,GAAG,iBAAiB,CAsB7E"}

package/dist/commands/detach.js

@@ -0,0 +1,31 @@
+import chalk from "chalk";
+import { PactileExitManager, } from "../pactile/exit/service.js";
+import { homedirBypassEnabled, homedirGuardMessage, isCwdHomedir, } from "../utils/cwd-guard.js";
+function adapterId(value) {
+    if (value === "cursor" || value === "codex")
+        return `adapter.${value}`;
+    return value;
+}
+export function detach(options) {
+    if (isCwdHomedir() && !homedirBypassEnabled())
+        throw new Error(homedirGuardMessage("detach"));
+    const manager = new PactileExitManager(process.cwd());
+    const planned = manager.planDetach(adapterId(options.adapter));
+    if (planned.status !== "ready")
+        throw new Error(`Cannot safely detach Adapter: ${planned.reason}`);
+    if (options.dryRun) {
+        console.log(chalk.bold("\nPactile Adapter detach preview\n"));
+        console.log(`  Adapter: ${planned.adapterId}`);
+        console.log(`  Decisions: ${planned.preview.decisions.length}`);
+        console.log(`  Preview fingerprint: ${planned.previewFingerprint}`);
+        console.log(chalk.gray("\nDry run — no files or state were modified."));
+        return planned;
+    }
+    const result = manager.applyDetach(planned);
+    if ("reason" in result)
+        throw new Error(`Adapter detach stopped safely: ${result.reason}`);
+    console.log(chalk.green(`Detached ${result.adapterId}.`));
+    console.log(chalk.gray(`Exit receipt: ${result.receipt.fingerprint}`));
+    return result;
+}
+//# sourceMappingURL=detach.js.map

package/dist/commands/detach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detach.js","sourceRoot":"","sources":["../../src/commands/detach.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EACL,kBAAkB,GAGnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,GACb,MAAM,uBAAuB,CAAC;AAO/B,SAAS,SAAS,CAAC,KAAa;IAC9B,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,WAAW,KAAK,EAAE,CAAC;IACvE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,OAAsB;IAC3C,IAAI,YAAY,EAAE,IAAI,CAAC,oBAAoB,EAAE;QAC3C,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO;QAC5B,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAErE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,CAAC,0BAA0B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC,CAAC;QACxE,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,QAAQ,IAAI,MAAM;QACpB,MAAM,IAAI,KAAK,CAAC,kCAAkC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACvE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,51 @@
+export declare function isSupportedPythonVersion(versionOutput: string): boolean;
+export declare function requireSupportedPython(command: string): string;
+/**
+ * Detect a working Python ≥ 3.9 command on the host platform.
+ *
+ * Honors `PACTILE_PYTHON_CMD` (explicit override, no probe) and
+ * `PACTILE_SKIP_PYTHON_CHECK=1` (skip probe, trust platform default).
+ *
+ * Otherwise tries each candidate in `PYTHON_CANDIDATES` in order and returns
+ * the first whose `--version` matches `Python ≥ 3.9`. Caches the result via
+ * `setResolvedPythonCommand` so all downstream template / configurator
+ * writes pick up the resolved value.
+ *
+ * Throws a helpful, Windows-aware error if no candidate works.
+ */
+export declare function resolveSupportedPython(): {
+    command: string;
+    version: string;
+};
+/**
+ * Slugify a developer name for safe use in task directory names.
+ *
+ * Unlike `sanitizePkgName` (which only strips npm @scope/ prefixes), this
+ * handles arbitrary developer input: spaces, Unicode letters, punctuation,
+ * path separators. Returns "user" fallback when input slugifies to empty.
+ *
+ * Exported for unit testing; not part of the public API.
+ */
+export declare function slugifyDeveloperName(name: string): string;
+interface InitOptions {
+    cursor?: boolean;
+    codex?: boolean;
+    importCstl?: boolean;
+    yes?: boolean;
+    user?: string;
+    force?: boolean;
+    skipExisting?: boolean;
+    skipReadiness?: boolean;
+    capability?: string[];
+    withOptional?: string[];
+    template?: string;
+    overwrite?: boolean;
+    append?: boolean;
+    registry?: string;
+    monorepo?: boolean;
+    workflow?: string;
+    workflowSource?: string;
+}
+export declare function init(options: InitOptions): Promise<void>;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAmGA,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAUvE;AAuBD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoC9D;AAmBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAwEA;AAQD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOzD;AAuuBD,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAkGD,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAo+B9D"}