@blxzer/pactile 0.5.0

package/dist/utils/semantic-plan-gate.js

@@ -0,0 +1,24 @@
+export function semanticProviderOrderFromEnvelope(plan) {
+    const step = plan.steps.find((candidate) => candidate.intent === "semantic" && candidate.kind === "provider-request");
+    return step?.order ?? null;
+}
+/**
+ * Render a neutral reminder. The text deliberately leaves tool and Provider
+ * selection to the project resolver/Adapter.
+ */
+export function semanticComplianceGateHint(plan, locale = "zh") {
+    const step = plan.steps.find((candidate) => candidate.intent === "semantic" && candidate.kind === "provider-request");
+    if (!step?.providerRequirement)
+        return "";
+    const status = step.providerRequirement.status;
+    if (locale === "en") {
+        return (`**Semantic retrieval gate:** step #${step.order} requests a project-resolved ` +
+            `semantic capability at minimum assurance \`${plan.minimumAssurance}\` ` +
+            `(status: \`${status}\`). Treat every result as a candidate until source, Git, ` +
+            "or repeatable-test corroboration succeeds.");
+    }
+    return (`**语义检索门控：** 第 ${step.order} 步请求由项目 Resolver 解析的语义能力，` +
+        `最低 assurance 为 \`${plan.minimumAssurance}\`（状态：\`${status}\`）。` +
+        "所有结果在源码、Git 或可重复测试完成佐证前都只能作为 candidate。");
+}
+//# sourceMappingURL=semantic-plan-gate.js.map

package/dist/utils/semantic-plan-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-plan-gate.js","sourceRoot":"","sources":["../../src/utils/semantic-plan-gate.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iCAAiC,CAC/C,IAAkD;IAElD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAC1B,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,CAAC,MAAM,KAAK,UAAU,IAAI,SAAS,CAAC,IAAI,KAAK,kBAAkB,CAC3E,CAAC;IACF,OAAO,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAAuE,EACvE,SAAsB,IAAI;IAE1B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAC1B,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,CAAC,MAAM,KAAK,UAAU,IAAI,SAAS,CAAC,IAAI,KAAK,kBAAkB,CAC3E,CAAC;IACF,IAAI,CAAC,IAAI,EAAE,mBAAmB;QAAE,OAAO,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC;IAC/C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,CACL,sCAAsC,IAAI,CAAC,KAAK,+BAA+B;YAC/E,8CAA8C,IAAI,CAAC,gBAAgB,KAAK;YACxE,cAAc,MAAM,4DAA4D;YAChF,4CAA4C,CAC7C,CAAC;IACJ,CAAC;IACD,OAAO,CACL,iBAAiB,IAAI,CAAC,KAAK,2BAA2B;QACtD,oBAAoB,IAAI,CAAC,gBAAgB,WAAW,MAAM,MAAM;QAChE,yCAAyC,CAC1C,CAAC;AACJ,CAAC"}

package/dist/utils/task-json.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Canonical task.json shape — single source of truth shared by all TS
+ * writers. The canonical types and factory now live in the
+ * `@blxzer/pactile-core` task API; this module re-exports them under
+ * the legacy `TaskJson` / `emptyTaskJson` names for CLI call sites.
+ *
+ * New code should prefer `PactileTaskRecord` / `emptyTaskRecord` from
+ * `@blxzer/pactile-core/task` directly.
+ */
+import { emptyTaskRecord, type PactileTaskRecord } from "@blxzer/pactile-core/task";
+export type TaskJson = PactileTaskRecord;
+export declare const emptyTaskJson: typeof emptyTaskRecord;
+//# sourceMappingURL=task-json.d.ts.map

package/dist/utils/task-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-json.d.ts","sourceRoot":"","sources":["../../src/utils/task-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,eAAe,EACf,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,QAAQ,GAAG,iBAAiB,CAAC;AAEzC,eAAO,MAAM,aAAa,wBAAkB,CAAC"}

package/dist/utils/task-json.js

@@ -0,0 +1,12 @@
+/**
+ * Canonical task.json shape — single source of truth shared by all TS
+ * writers. The canonical types and factory now live in the
+ * `@blxzer/pactile-core` task API; this module re-exports them under
+ * the legacy `TaskJson` / `emptyTaskJson` names for CLI call sites.
+ *
+ * New code should prefer `PactileTaskRecord` / `emptyTaskRecord` from
+ * `@blxzer/pactile-core/task` directly.
+ */
+import { emptyTaskRecord, } from "@blxzer/pactile-core/task";
+export const emptyTaskJson = emptyTaskRecord;
+//# sourceMappingURL=task-json.js.map

package/dist/utils/task-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-json.js","sourceRoot":"","sources":["../../src/utils/task-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,eAAe,GAEhB,MAAM,2BAA2B,CAAC;AAInC,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC"}

package/dist/utils/template-fetcher.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Remote template fetcher for the Pactile CLI
+ *
+ * Fetches spec templates from the official marketplace:
+ * https://github.com/mindfold-ai/marketplace
+ */
+export declare const TEMPLATE_INDEX_URL = "https://raw.githubusercontent.com/mindfold-ai/marketplace/main/index.json";
+/** Timeout constants for network operations */
+export declare const TIMEOUTS: {
+    /** Timeout for fetching the template index (ms) */
+    readonly INDEX_FETCH_MS: 5000;
+    /** Timeout for downloading a template via giget (ms) */
+    readonly DOWNLOAD_MS: 30000;
+};
+export interface SpecTemplate {
+    id: string;
+    type: string;
+    name: string;
+    description?: string;
+    path: string;
+    tags?: string[];
+}
+export type TemplateStrategy = "skip" | "overwrite" | "append";
+export type RegistryBackend = "http" | "git";
+export type RegistrySourceKind = "prefixed" | "https" | "ssh";
+export type RegistryErrorKind = "auth" | "git-unavailable" | "invalid-json" | "network" | "not-found" | "path-not-found" | "ref-not-found" | "unknown";
+export declare class RegistryBackendError extends Error {
+    readonly kind: RegistryErrorKind;
+    constructor(kind: RegistryErrorKind, message: string);
+}
+export interface RegistryProbeResult {
+    templates: SpecTemplate[];
+    isNotFound: boolean;
+    backend: RegistryBackend;
+    error?: RegistryBackendError;
+}
+export interface RegistrySource {
+    /** Original provider prefix (e.g., "gh", "gitlab", "bitbucket") */
+    provider: string;
+    /** Repository path (e.g., "myorg/myrepo") */
+    repo: string;
+    /** Subdirectory within the repo (e.g., "marketplace" or "specs/my-template") */
+    subdir: string;
+    /** Git ref / branch (default: "main") */
+    ref: string;
+    /** Base URL for fetching raw files (e.g., index.json) */
+    rawBaseUrl: string;
+    /** Full giget source string for downloading */
+    gigetSource: string;
+    /** Custom host for self-hosted instances (e.g., "git.company.com"). Undefined for public providers. */
+    host?: string;
+    /** Git remote URL used by git-backed registry access. */
+    gitUrl: string;
+    /** Whether registry access should prefer Git over anonymous raw HTTP. */
+    preferGit: boolean;
+    /** Input family used to derive credential behavior and clone URL shape. */
+    sourceKind: RegistrySourceKind;
+}
+export declare const SUPPORTED_PROVIDERS: string[];
+/**
+ * Convert an HTTPS URL to giget-style source format.
+ * e.g. "https://github.com/user/repo" → "gh:user/repo"
+ *      "https://github.com/user/repo/tree/branch/path" → "gh:user/repo/path#branch"
+ * Returns the original string if it's not a recognized HTTPS URL.
+ */
+export declare function normalizeRegistrySource(source: string): string;
+/**
+ * Parse a giget-style registry source into its components.
+ *
+ * Supported input formats:
+ * | Format                              | Example                                      | Provider  | Host?     |
+ * |-------------------------------------|----------------------------------------------|-----------|-----------|
+ * | giget prefix                        | gh:org/repo, gitlab:org/repo#ref             | native    | no        |
+ * | Public HTTPS                        | https://github.com/org/repo                  | native    | no        |
+ * | Public SSH                          | git@github.com:org/repo                      | native    | no        |
+ * | Self-hosted HTTPS                   | https://git.corp.com/org/repo                | gitlab    | yes       |
+ * | Self-hosted SSH                     | git@git.corp.com:org/repo                    | gitlab    | yes       |
+ * | ssh:// protocol (with/without port) | ssh://git@host:2222/org/repo                 | gitlab    | yes       |
+ * | HTTPS with port                     | https://host:8443/org/repo                   | gitlab    | yes       |
+ * | GitLab browse URL                   | https://host/org/repo/-/tree/branch/path     | gitlab    | yes       |
+ *
+ * Ref defaults to "main" if not specified.
+ * Unknown domains default to GitLab URL patterns (covers self-hosted GitLab CE/EE).
+ *
+ * @throws Error if provider is unsupported
+ */
+export declare function parseRegistrySource(source: string): RegistrySource;
+/**
+ * Fetch available templates from the remote index
+ * Returns empty array on network error or timeout (allows fallback to blank)
+ *
+ * @param indexUrl - URL to fetch index.json from (defaults to official marketplace)
+ */
+export declare function fetchTemplateIndex(indexUrl?: string): Promise<SpecTemplate[]>;
+/**
+ * Probe a registry's index.json, distinguishing "not found" from transient errors.
+ * Used by the registry flow to decide marketplace vs direct-download mode.
+ *
+ * - 404 → { templates: [], isNotFound: true }
+ * - Other HTTP error / network timeout → { templates: [], isNotFound: false }
+ * - 200 + valid JSON → { templates: [...], isNotFound: false }
+ */
+export declare function probeRegistryIndex(indexUrl: string, registry?: RegistrySource): Promise<RegistryProbeResult>;
+/**
+ * Find a template by ID from the index
+ */
+export declare function findTemplate(templateId: string, indexUrl?: string): Promise<SpecTemplate | null>;
+/**
+ * Get the installation path for a template type
+ */
+export declare function getInstallPath(cwd: string, templateType: string): string;
+/**
+ * Download a template with the specified strategy
+ *
+ * @param templatePath - Path in the docs repo (e.g., "marketplace/specs/electron-fullstack")
+ *                       OR a full giget source (e.g., "gh:myorg/myrepo/my-spec")
+ * @param destDir - Destination directory
+ * @param strategy - How to handle existing directory: skip, overwrite, or append
+ * @param repoSource - Optional giget repo source override. When set, templatePath is
+ *                     treated as relative to this repo. When not set, uses TEMPLATE_REPO.
+ *                     Pass null to use templatePath as a full giget source directly.
+ * @returns true if template was downloaded, false if skipped
+ */
+export declare function downloadWithStrategy(templatePath: string, destDir: string, strategy: TemplateStrategy, repoSource?: string | null): Promise<boolean>;
+/**
+ * Download a template by ID
+ *
+ * @param cwd - Current working directory
+ * @param templateId - Template ID from the index
+ * @param strategy - How to handle existing directory
+ * @param template - Optional pre-fetched SpecTemplate to avoid double-fetch
+ * @param registry - Optional registry source (parsed). When set, uses the registry's
+ *                   repo as the giget source instead of the default TEMPLATE_REPO.
+ * @returns Object with success status and message
+ */
+export declare function downloadTemplateById(cwd: string, templateId: string, strategy: TemplateStrategy, template?: SpecTemplate, registry?: RegistrySource, destDirOverride?: string, registryBackend?: RegistryBackend): Promise<{
+    success: boolean;
+    message: string;
+    skipped?: boolean;
+}>;
+/**
+ * Download a registry source directly to the spec directory (no index.json).
+ * Used when the registry source points to a spec directory, not a marketplace.
+ */
+export declare function downloadRegistryDirect(cwd: string, registry: RegistrySource, strategy: TemplateStrategy, destDirOverride?: string, registryBackend?: RegistryBackend): Promise<{
+    success: boolean;
+    message: string;
+    skipped?: boolean;
+}>;
+//# sourceMappingURL=template-fetcher.d.ts.map

package/dist/utils/template-fetcher.d.ts.map

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