@blxzer/pactile 0.5.0

package/dist/utils/workflow-dir.js

@@ -0,0 +1,33 @@
+import path from "node:path";
+import fs from "node:fs";
+import { resolveLegacyWorkflowDirName } from "../pactile/runtime/paths.js";
+/** Pre-0.3.1 cursor-trellis runtime directory (upstream Trellis still uses this name). */
+export const LEGACY_WORKFLOW_DIR = ".trellis";
+export const LEGACY_CSTL_WORKFLOW_DIR = ".cstl";
+export const CANONICAL_WORKFLOW_DIR = ".pactile";
+/**
+ * Resolve the active workflow directory name for this project. New writes use
+ * `.pactile/`; legacy roots remain read-only discovery inputs during 0.5.x.
+ */
+export function resolveWorkflowDirName(cwd) {
+    if (fs.existsSync(path.join(cwd, CANONICAL_WORKFLOW_DIR)))
+        return CANONICAL_WORKFLOW_DIR;
+    return resolveLegacyWorkflowDirName(cwd);
+}
+/** Absolute path to the active workflow root, or null when not initialized. */
+export function workflowDirPath(cwd) {
+    const name = resolveWorkflowDirName(cwd);
+    return name ? path.join(cwd, name) : null;
+}
+export function isWorkflowInitialized(cwd) {
+    return resolveWorkflowDirName(cwd) !== null;
+}
+/** Join a path segment under the active workflow dir (POSIX-style relative segments). */
+export function workflowPath(cwd, ...segments) {
+    const root = workflowDirPath(cwd);
+    if (!root) {
+        return null;
+    }
+    return path.join(root, ...segments);
+}
+//# sourceMappingURL=workflow-dir.js.map

package/dist/utils/workflow-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-dir.js","sourceRoot":"","sources":["../../src/utils/workflow-dir.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAE3E,0FAA0F;AAC1F,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAC9C,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAChD,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAU,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;QACvD,OAAO,sBAAsB,CAAC;IAChC,OAAO,4BAA4B,CAAC,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,IAAI,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,OAAO,sBAAsB,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;AAC9C,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,YAAY,CAC1B,GAAW,EACX,GAAG,QAAkB;IAErB,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;AACtC,CAAC"}

package/dist/utils/workflow-resolver.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Workflow template resolver.
+ *
+ * Centralizes how `pactile init --workflow` and `pactile workflow` discover and
+ * fetch workflow.md content. Reuses `template-fetcher` helpers for registry
+ * parsing, index probing, and git/http transport. The `native` workflow is a
+ * virtual entry resolved directly from the bundled `workflowMdTemplate` to
+ * avoid a duplicate file on disk that could drift out of sync.
+ *
+ * Boundary: command-layer callers (init.ts, commands/workflow.ts) should NOT
+ * touch raw marketplace structures. They go through `resolveWorkflowTemplate`
+ * and `listWorkflowTemplates` only.
+ */
+/**
+ * The id used to refer to the bundled native workflow.
+ *
+ * Treated as Pactile-managed for hash-tracking: when this id is selected by
+ * `init --workflow` or `pactile workflow`, `.pactile/workflow.md` stays in
+ * `.template-hashes.json`. Any other id is user-managed local workflow and
+ * must be removed from the hash file (the durable-state contract in
+ * design.md "Durable-state contract").
+ */
+export declare const NATIVE_WORKFLOW_ID = "native";
+/**
+ * Resolved workflow template entry.
+ *
+ * `content` is the workflow.md body bytes (LF-normalized in storage).
+ * `path` is the marketplace-relative path for remote entries, or
+ *   `bundled:pactile/workflow.md` for the native virtual entry.
+ */
+export interface ResolvedWorkflowTemplate {
+    id: string;
+    type: "workflow";
+    name: string;
+    description?: string;
+    path: string;
+    content: string;
+    /** Where the content came from (for error messages). */
+    source: "bundled" | "marketplace";
+}
+/**
+ * Workflow template listing (metadata only, no content).
+ */
+export interface WorkflowTemplateListing {
+    id: string;
+    type: "workflow";
+    name: string;
+    description?: string;
+    path: string;
+    source: "bundled" | "marketplace";
+}
+export interface WorkflowResolveOptions {
+    /**
+     * Optional marketplace source (giget-style or HTTPS URL).
+     * Omitted = use the default marketplace via TEMPLATE_INDEX_URL.
+     */
+    source?: string;
+}
+export declare class WorkflowResolveError extends Error {
+    constructor(message: string);
+}
+/**
+ * List available workflow templates from the default marketplace (or a
+ * user-supplied source). The bundled native entry is always included first.
+ *
+ * Returns metadata only — no content is fetched. Use `resolveWorkflowTemplate`
+ * to fetch the actual workflow.md bytes for a chosen id.
+ *
+ * Network errors are surfaced as `errorMessage`. The native entry is still
+ * returned so callers can fall back to it offline.
+ */
+export declare function listWorkflowTemplates(options?: WorkflowResolveOptions): Promise<{
+    templates: WorkflowTemplateListing[];
+    errorMessage?: string;
+}>;
+/**
+ * Resolve a workflow id to its content.
+ *
+ * - `native` → bundled `workflowMdTemplate` (offline, never errors).
+ * - other id → fetch index via `template-fetcher`, find the matching
+ *   `type: "workflow"` entry, then fetch its single file content.
+ *
+ * Errors are workflow-specific (do NOT reuse "spec template not found" copy).
+ */
+export declare function resolveWorkflowTemplate(id: string, options?: WorkflowResolveOptions): Promise<ResolvedWorkflowTemplate>;
+//# sourceMappingURL=workflow-resolver.d.ts.map

package/dist/utils/workflow-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/workflow-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAkBH;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,MAAM,EAAE,SAAS,GAAG,aAAa,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,aAAa,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AA+DD;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC;IACT,SAAS,EAAE,uBAAuB,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC,CA6BD;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,wBAAwB,CAAC,CAoDnC"}

package/dist/utils/workflow-resolver.js

@@ -0,0 +1,265 @@
+/**
+ * Workflow template resolver.
+ *
+ * Centralizes how `pactile init --workflow` and `pactile workflow` discover and
+ * fetch workflow.md content. Reuses `template-fetcher` helpers for registry
+ * parsing, index probing, and git/http transport. The `native` workflow is a
+ * virtual entry resolved directly from the bundled `workflowMdTemplate` to
+ * avoid a duplicate file on disk that could drift out of sync.
+ *
+ * Boundary: command-layer callers (init.ts, commands/workflow.ts) should NOT
+ * touch raw marketplace structures. They go through `resolveWorkflowTemplate`
+ * and `listWorkflowTemplates` only.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { workflowMdTemplate } from "../templates/pactile/index.js";
+import { TIMEOUTS, TEMPLATE_INDEX_URL, RegistryBackendError, parseRegistrySource, probeRegistryIndex, } from "./template-fetcher.js";
+/**
+ * The id used to refer to the bundled native workflow.
+ *
+ * Treated as Pactile-managed for hash-tracking: when this id is selected by
+ * `init --workflow` or `pactile workflow`, `.pactile/workflow.md` stays in
+ * `.template-hashes.json`. Any other id is user-managed local workflow and
+ * must be removed from the hash file (the durable-state contract in
+ * design.md "Durable-state contract").
+ */
+export const NATIVE_WORKFLOW_ID = "native";
+export class WorkflowResolveError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WorkflowResolveError";
+    }
+}
+/**
+ * Bundled native workflow entry — virtual, resolved without network access.
+ */
+function nativeListingEntry() {
+    return {
+        id: NATIVE_WORKFLOW_ID,
+        type: "workflow",
+        name: "Native Pactile Workflow",
+        description: "Default Pactile Plan / Execute / Finish workflow bundled with the CLI",
+        path: "bundled:pactile/workflow.md",
+        source: "bundled",
+    };
+}
+function nativeResolvedEntry() {
+    return {
+        ...nativeListingEntry(),
+        content: workflowMdTemplate,
+    };
+}
+function parseSourceOrThrow(source) {
+    try {
+        return parseRegistrySource(source);
+    }
+    catch (err) {
+        throw new WorkflowResolveError(`Invalid workflow marketplace source "${source}": ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+async function fetchWorkflowEntries(registry, indexUrl) {
+    const probe = await probeRegistryIndex(indexUrl, registry);
+    if (probe.error) {
+        return {
+            templates: [],
+            backend: probe.backend,
+            errorMessage: probe.error.message,
+        };
+    }
+    if (probe.isNotFound) {
+        return {
+            templates: [],
+            backend: probe.backend,
+            errorMessage: "No marketplace index.json found at the configured source. Workflow templates require an index.json.",
+        };
+    }
+    return { templates: probe.templates, backend: probe.backend };
+}
+/**
+ * List available workflow templates from the default marketplace (or a
+ * user-supplied source). The bundled native entry is always included first.
+ *
+ * Returns metadata only — no content is fetched. Use `resolveWorkflowTemplate`
+ * to fetch the actual workflow.md bytes for a chosen id.
+ *
+ * Network errors are surfaced as `errorMessage`. The native entry is still
+ * returned so callers can fall back to it offline.
+ */
+export async function listWorkflowTemplates(options = {}) {
+    const result = [nativeListingEntry()];
+    let registry;
+    let indexUrl = TEMPLATE_INDEX_URL;
+    if (options.source) {
+        registry = parseSourceOrThrow(options.source);
+        indexUrl = `${registry.rawBaseUrl}/index.json`;
+    }
+    const fetched = await fetchWorkflowEntries(registry, indexUrl);
+    if (fetched.errorMessage) {
+        return { templates: result, errorMessage: fetched.errorMessage };
+    }
+    for (const t of fetched.templates) {
+        if (t.type !== "workflow")
+            continue;
+        if (t.id === NATIVE_WORKFLOW_ID)
+            continue;
+        result.push({
+            id: t.id,
+            type: "workflow",
+            name: t.name,
+            ...(t.description ? { description: t.description } : {}),
+            path: t.path,
+            source: "marketplace",
+        });
+    }
+    return { templates: result };
+}
+/**
+ * Resolve a workflow id to its content.
+ *
+ * - `native` → bundled `workflowMdTemplate` (offline, never errors).
+ * - other id → fetch index via `template-fetcher`, find the matching
+ *   `type: "workflow"` entry, then fetch its single file content.
+ *
+ * Errors are workflow-specific (do NOT reuse "spec template not found" copy).
+ */
+export async function resolveWorkflowTemplate(id, options = {}) {
+    if (id === NATIVE_WORKFLOW_ID) {
+        return nativeResolvedEntry();
+    }
+    let registry;
+    let indexUrl = TEMPLATE_INDEX_URL;
+    if (options.source) {
+        registry = parseSourceOrThrow(options.source);
+        indexUrl = `${registry.rawBaseUrl}/index.json`;
+    }
+    const fetched = await fetchWorkflowEntries(registry, indexUrl);
+    if (fetched.errorMessage) {
+        throw new WorkflowResolveError(`Could not fetch workflow template index: ${fetched.errorMessage}`);
+    }
+    const entry = fetched.templates.find((t) => t.id === id && t.type === "workflow");
+    if (!entry) {
+        const available = fetched.templates
+            .filter((t) => t.type === "workflow")
+            .map((t) => t.id);
+        const hint = available.length > 0
+            ? ` Available workflow templates: ${available.join(", ")}`
+            : "";
+        throw new WorkflowResolveError(`Workflow template "${id}" not found in marketplace index.${hint}`);
+    }
+    if (!entry.path?.endsWith(".md")) {
+        throw new WorkflowResolveError(`Workflow template "${id}" has invalid path "${entry.path}" — must point to a workflow.md file.`);
+    }
+    const backend = fetched.backend;
+    const content = await fetchWorkflowFile(entry.path, registry, backend);
+    return {
+        id: entry.id,
+        type: "workflow",
+        name: entry.name,
+        ...(entry.description ? { description: entry.description } : {}),
+        path: entry.path,
+        content,
+        source: "marketplace",
+    };
+}
+async function fetchWorkflowFile(relativePath, registry, backend) {
+    validateWorkflowPath(relativePath);
+    const useGit = registry?.preferGit ?? backend === "git";
+    if (registry && useGit) {
+        return fetchWorkflowFileGit(registry, relativePath);
+    }
+    const rawBase = registry
+        ? registry.rawBaseUrl
+        : TEMPLATE_INDEX_URL.replace(/\/index\.json$/, "");
+    return fetchWorkflowFileHttp(rawBase, relativePath);
+}
+async function fetchWorkflowFileHttp(rawBaseUrl, relativePath) {
+    const url = `${rawBaseUrl.replace(/\/$/, "")}/${relativePath}`;
+    try {
+        const res = await fetch(url, {
+            signal: AbortSignal.timeout(TIMEOUTS.DOWNLOAD_MS),
+        });
+        if (res.status === 404) {
+            throw new WorkflowResolveError(`Workflow template file not found at ${url}.`);
+        }
+        if (!res.ok) {
+            throw new WorkflowResolveError(`Could not fetch workflow template (HTTP ${res.status}) from ${url}.`);
+        }
+        return await res.text();
+    }
+    catch (err) {
+        if (err instanceof WorkflowResolveError)
+            throw err;
+        throw new WorkflowResolveError(`Workflow template download failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+function validateWorkflowPath(relativePath) {
+    const normalized = relativePath.replace(/\\/g, "/");
+    if (normalized.startsWith("/") ||
+        normalized.split("/").some((part) => part === "..")) {
+        throw new WorkflowResolveError(`Workflow template path "${relativePath}" must stay inside the marketplace root.`);
+    }
+}
+async function fetchWorkflowFileGit(registry, relativePath) {
+    // Single shallow clone of the registry ref, then read one file. We don't
+    // share clone state with template-fetcher's downloadGitRegistryPath because
+    // workflow resolution is a single-file fetch (not a directory copy).
+    const { execFile } = await import("node:child_process");
+    const dir = await fs.promises.mkdtemp(path.join(os.tmpdir(), "pactile-workflow-"));
+    function run(args) {
+        return new Promise((resolve, reject) => {
+            execFile("git", args, {
+                encoding: "utf-8",
+                maxBuffer: 10 * 1024 * 1024,
+                timeout: TIMEOUTS.DOWNLOAD_MS,
+            }, (error) => {
+                if (error)
+                    reject(error);
+                else
+                    resolve();
+            });
+        });
+    }
+    try {
+        try {
+            await run([
+                "clone",
+                "--filter=blob:none",
+                "--no-checkout",
+                registry.gitUrl,
+                dir,
+            ]);
+            await run(["-C", dir, "fetch", "--depth", "1", "origin", registry.ref]);
+            await run(["-C", dir, "checkout", "--detach", "FETCH_HEAD"]);
+        }
+        catch (err) {
+            throw new RegistryBackendError("network", `Could not clone registry ${registry.gitUrl}#${registry.ref}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        const subdir = registry.subdir.length > 0 ? registry.subdir : ".";
+        const sourceRoot = path.resolve(dir, subdir);
+        const candidatePath = path.resolve(sourceRoot, relativePath);
+        const rel = path.relative(sourceRoot, candidatePath);
+        if (rel.startsWith("..") || path.isAbsolute(rel)) {
+            throw new WorkflowResolveError(`Workflow template path "${relativePath}" escapes the marketplace root.`);
+        }
+        if (!fs.existsSync(candidatePath)) {
+            throw new WorkflowResolveError(`Workflow template file "${relativePath}" not found in ${registry.gitUrl}#${registry.ref}.`);
+        }
+        return await fs.promises.readFile(candidatePath, "utf-8");
+    }
+    catch (err) {
+        if (err instanceof WorkflowResolveError)
+            throw err;
+        if (err instanceof RegistryBackendError) {
+            throw new WorkflowResolveError(err.message);
+        }
+        throw new WorkflowResolveError(`Workflow template download failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    finally {
+        await fs.promises.rm(dir, { recursive: true, force: true }).catch(() => {
+            // best-effort cleanup; the OS will reap tmp dirs eventually
+        });
+    }
+}
+//# sourceMappingURL=workflow-resolver.js.map

package/dist/utils/workflow-resolver.js.map

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

package/package.json

@@ -0,0 +1,117 @@
+{
+  "name": "@blxzer/pactile",
+  "version": "0.5.0",
+  "description": "Pactile composes portable AI development capabilities across supported agent platforms",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "pactile": "./bin/pactile.js",
+    "cstl": "./bin/cstl.js",
+    "smart-search": "./bin/smart-search.js"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./cli": "./dist/cli/index.js",
+    "./compat": "./bin/compat-warning.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "ai",
+    "workflow",
+    "cursor",
+    "claude",
+    "iflow",
+    "cli",
+    "developer-tools",
+    "agent",
+    "memory",
+    "pactile"
+  ],
+  "author": "Mindfold LLC",
+  "license": "AGPL-3.0-only",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "figlet": "^1.9.4",
+    "giget": "^3.1.1",
+    "inquirer": "^9.3.7",
+    "undici": "^6.21.0",
+    "zod": "^4.4.2",
+    "@blxzer/pactile-core": "0.5.0"
+  },
+  "optionalDependencies": {
+    "@blxzer/smart-search": "^0.2.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.18.0",
+    "@types/figlet": "^1.7.0",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.17.10",
+    "@vitest/coverage-v8": "^4.0.18",
+    "basedpyright": "^1.37.2",
+    "eslint": "^9.18.0",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.21.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "scripts/postinstall.js",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/blxzer77/pactile.git"
+  },
+  "scripts": {
+    "build": "pnpm run clean && tsc && pnpm run copy-templates",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "copy-templates": "node scripts/copy-templates.js",
+    "postinstall": "node scripts/postinstall.js",
+    "check:pack-files": "node scripts/check-cli-pack-files.js",
+    "check:release-pack": "node scripts/check-release-pack-contents.js",
+    "check:router-copy-sync": "node scripts/check-router-copy-sync.js",
+    "check:router-copy-sync:hash": "node scripts/check-router-copy-sync.js --hash-only",
+    "docs:smoke": "node scripts/docs-smoke.js",
+    "mirror-check": "node scripts/mirror-check.js",
+    "copy:release-assets": "node scripts/copy-release-assets.js",
+    "sync:pack-files": "node scripts/sync-cli-pack-files.js",
+    "dev": "tsc --watch",
+    "start": "node ./dist/cli/index.js",
+    "test": "vitest run --maxWorkers=4",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/ test/",
+    "lint:fix": "eslint src/ test/ --fix",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
+    "typecheck": "tsc --noEmit",
+    "lint:py": "basedpyright",
+    "lint:all": "pnpm lint && pnpm lint:py",
+    "release": "node scripts/release.js patch",
+    "release:minor": "node scripts/release.js minor",
+    "release:major": "node scripts/release.js major",
+    "release:beta": "node scripts/release.js beta",
+    "release:rc": "node scripts/release.js rc",
+    "release:promote": "node scripts/release.js promote",
+    "release:prepare": "node scripts/publish-packages.js --prepare-only",
+    "release:publish": "node scripts/publish-packages.js --publish-only",
+    "release:publish:dry": "node scripts/publish-packages.js --dry-run",
+    "manifest": "node scripts/create-manifest.js"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+
+// smart-search is an optional independent Middleware Provider.
+// Missing package must not fail Pactile install. This script stays a no-op.
+
+process.exit(0);