trellis-hgl 0.6.0-beta.18

package/dist/utils/uninstall-scrubbers.js

@@ -0,0 +1,342 @@
+/**
+ * Scrubbers for structured config files during `trellis uninstall`.
+ *
+ * Each scrubber takes the file content (and any context it needs) and returns
+ * `{ content, fullyEmpty }`:
+ * - `content` is the post-scrub text to write back if the file should remain.
+ * - `fullyEmpty` is true when, after stripping every trellis-managed value,
+ *   nothing meaningful is left. The caller deletes the file in that case.
+ *
+ * Manifest path matching (for hooks.json scrubbers) uses substring containment
+ * on the resolved `command` string. The leading `python3 ` / `python ` prefix
+ * does not matter — we just look for the manifest-relative file path.
+ */
+/**
+ * Test whether a hook command string references any of the given manifest paths.
+ *
+ * Trellis-emitted hook commands always have the shape
+ *   `<python-cmd> <manifest-path>`
+ * so the trailing whitespace-delimited token is the script path. We compare
+ * that last token (with surrounding quotes stripped) against the manifest
+ * delete-set. This is intentionally stricter than substring matching: a
+ * user-added hook whose body merely mentions a deleted path inside an `echo`
+ * or comment argument (`echo "see .claude/hooks/session-start.py"`) does NOT
+ * match, because the trailing token is `inspiration"` (or similar) — not the
+ * path. We also accept absolute-path variants like
+ * `/Users/me/proj/.claude/hooks/session-start.py` via `endsWith("/" + p)`.
+ */
+function commandMatchesDeletedPath(command, deletedPaths) {
+    const trimmed = command.trim();
+    if (trimmed.length === 0)
+        return false;
+    const tokens = trimmed.split(/\s+/);
+    const lastToken = tokens[tokens.length - 1].replace(/^["']|["']$/g, "");
+    if (lastToken.length === 0)
+        return false;
+    for (const p of deletedPaths) {
+        if (lastToken === p || lastToken.endsWith("/" + p)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Read the `command` (or fallback `bash` / `powershell`) string out of an
+ * arbitrary hook entry. Copilot's flat schema uses `bash` + `powershell`
+ * instead of `command` for some events.
+ */
+function getEntryCommand(entry) {
+    if (entry === null || typeof entry !== "object") {
+        return null;
+    }
+    const obj = entry;
+    if (typeof obj.command === "string")
+        return obj.command;
+    if (typeof obj.bash === "string")
+        return obj.bash;
+    if (typeof obj.powershell === "string")
+        return obj.powershell;
+    return null;
+}
+/**
+ * Scrub a hooks-shaped settings JSON file.
+ *
+ * `mode = "nested"` → `hooks.{Event}.[ {matcher?, hooks: [ {command,...} ]} ]`
+ * `mode = "flat"`   → `hooks.{Event}.[ {command,...} ]`
+ *
+ * Strips every entry whose command references a path in `deletedPaths`,
+ * then bottom-up cleans empty containers (matcher block, event array, hooks
+ * object). Any user-defined keys outside `hooks` (e.g. `env`, `model`,
+ * `permissions`, `version`) are preserved verbatim.
+ */
+export function scrubHooksJson(content, deletedPaths, mode) {
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        // Malformed JSON — leave it untouched, caller will skip.
+        return { content, fullyEmpty: false };
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return { content, fullyEmpty: false };
+    }
+    const root = parsed;
+    const hooks = root.hooks;
+    if (hooks === undefined) {
+        // No hooks block — nothing to scrub. Treat as fully empty only if the
+        // entire file has no other keys.
+        const fullyEmpty = Object.keys(root).length === 0;
+        return { content: JSON.stringify(root, null, 2) + "\n", fullyEmpty };
+    }
+    if (hooks === null || typeof hooks !== "object" || Array.isArray(hooks)) {
+        // hooks is some unexpected shape — leave it alone.
+        return { content, fullyEmpty: false };
+    }
+    const hooksObj = hooks;
+    for (const eventName of Object.keys(hooksObj)) {
+        const eventArr = hooksObj[eventName];
+        if (!Array.isArray(eventArr))
+            continue;
+        const filteredEvent = [];
+        for (const entry of eventArr) {
+            if (mode === "flat") {
+                const cmd = getEntryCommand(entry);
+                if (cmd !== null && commandMatchesDeletedPath(cmd, deletedPaths)) {
+                    continue; // drop trellis entry
+                }
+                filteredEvent.push(entry);
+            }
+            else {
+                // nested: entry is { matcher?, hooks: [...] }
+                if (entry === null || typeof entry !== "object") {
+                    filteredEvent.push(entry);
+                    continue;
+                }
+                const matcherBlock = entry;
+                const inner = matcherBlock.hooks;
+                if (!Array.isArray(inner)) {
+                    filteredEvent.push(entry);
+                    continue;
+                }
+                const filteredInner = inner.filter((sub) => {
+                    const cmd = getEntryCommand(sub);
+                    return !(cmd !== null && commandMatchesDeletedPath(cmd, deletedPaths));
+                });
+                if (filteredInner.length === 0) {
+                    // Whole matcher block is now empty → drop the block.
+                    continue;
+                }
+                // Reconstruct the block with the filtered inner list.
+                const rebuilt = { ...matcherBlock };
+                rebuilt.hooks = filteredInner;
+                filteredEvent.push(rebuilt);
+            }
+        }
+        if (filteredEvent.length === 0) {
+            // Drop the whole event array.
+            // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+            delete hooksObj[eventName];
+        }
+        else {
+            hooksObj[eventName] = filteredEvent;
+        }
+    }
+    // If hooks is empty → drop the key.
+    if (Object.keys(hooksObj).length === 0) {
+        delete root.hooks;
+    }
+    else {
+        root.hooks = hooksObj;
+    }
+    const fullyEmpty = Object.keys(root).length === 0;
+    return {
+        content: JSON.stringify(root, null, 2) + "\n",
+        fullyEmpty,
+    };
+}
+/**
+ * Scrub `.opencode/package.json`:
+ * - remove `dependencies["@opencode-ai/plugin"]`
+ * - if `dependencies` ends up empty → drop the field
+ * - fully empty when nothing is left in the object
+ */
+export function scrubOpencodePackageJson(content) {
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        return { content, fullyEmpty: false };
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return { content, fullyEmpty: false };
+    }
+    const root = parsed;
+    const deps = root.dependencies;
+    if (deps !== null && typeof deps === "object" && !Array.isArray(deps)) {
+        const depsObj = deps;
+        if ("@opencode-ai/plugin" in depsObj) {
+            delete depsObj["@opencode-ai/plugin"];
+        }
+        if (Object.keys(depsObj).length === 0) {
+            delete root.dependencies;
+        }
+        else {
+            root.dependencies = depsObj;
+        }
+    }
+    const fullyEmpty = Object.keys(root).length === 0;
+    return {
+        content: JSON.stringify(root, null, 2) + "\n",
+        fullyEmpty,
+    };
+}
+/**
+ * Trellis-specific values written by the Pi configurator.
+ *
+ * The `extensions`/`skills`/`prompts` arrays are paths relative to `.pi/`. We
+ * remove the exact entries that the Pi configurator emits.
+ */
+const PI_TRELLIS_EXTENSION = "./extensions/trellis/index.ts";
+const PI_TRELLIS_SKILLS = "./skills";
+const PI_TRELLIS_PROMPTS = "./prompts";
+const PI_SUBAGENTS_PACKAGE = "npm:pi-subagents";
+function isTrellisPiEntry(value, target) {
+    return typeof value === "string" && value === target;
+}
+/**
+ * Scrub `.pi/settings.json`:
+ * - drop `enableSkillCommands` (trellis-flagged)
+ * - remove trellis entries from `extensions`/`skills`/`prompts` arrays
+ * - remove trellis-managed `packages["npm:pi-subagents"]` isolation override
+ * - drop arrays that become empty
+ */
+export function scrubPiSettings(content) {
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        return { content, fullyEmpty: false };
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return { content, fullyEmpty: false };
+    }
+    const root = parsed;
+    if ("enableSkillCommands" in root) {
+        delete root.enableSkillCommands;
+    }
+    const arrayCleanups = [
+        ["extensions", PI_TRELLIS_EXTENSION],
+        ["skills", PI_TRELLIS_SKILLS],
+        ["prompts", PI_TRELLIS_PROMPTS],
+    ];
+    for (const [key, target] of arrayCleanups) {
+        const arr = root[key];
+        if (!Array.isArray(arr))
+            continue;
+        const filtered = arr.filter((v) => !isTrellisPiEntry(v, target));
+        if (filtered.length === 0) {
+            // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+            delete root[key];
+        }
+        else {
+            root[key] = filtered;
+        }
+    }
+    const packagesValue = root.packages;
+    if (Array.isArray(packagesValue)) {
+        const filtered = packagesValue.filter((entry) => {
+            if (entry !== null &&
+                typeof entry === "object" &&
+                !Array.isArray(entry)) {
+                const obj = entry;
+                return obj.source !== PI_SUBAGENTS_PACKAGE;
+            }
+            // String entries — keep unless they exactly match the package name
+            return entry !== PI_SUBAGENTS_PACKAGE;
+        });
+        if (filtered.length === 0) {
+            delete root.packages;
+        }
+        else {
+            root.packages = filtered;
+        }
+    }
+    const fullyEmpty = Object.keys(root).length === 0;
+    return {
+        content: JSON.stringify(root, null, 2) + "\n",
+        fullyEmpty,
+    };
+}
+/**
+ * Scrub `.codex/config.toml`.
+ *
+ * The current trellis-emitted file has two distinct chunks:
+ * 1. The line `project_doc_fallback_filenames = ["AGENTS.md"]`
+ * 2. A multi-line comment block that begins with the marker
+ *    `# NOTE: Trellis's SessionStart + UserPromptSubmit hooks require opt-in.`
+ *    and continues through `# be injected into Codex sessions.`
+ *
+ * Plus the leading "Project-scoped Codex defaults" header comments.
+ *
+ * Strategy: line-based removal. We strip:
+ *  - the `project_doc_fallback_filenames = ...` line
+ *  - any line that is *only* a comment introduced by trellis (the entire file
+ *    as shipped is comments + that one assignment)
+ *  - blank lines that surrounded those removals
+ *
+ * If the user added their own non-trellis lines, they are preserved as-is.
+ * "Fully empty" = post-scrub content has no non-whitespace characters.
+ */
+export function scrubCodexConfigToml(content) {
+    const trellisCommentMarkers = [
+        "Project-scoped Codex defaults for Trellis workflows.",
+        "Codex loads this after ~/.codex/config.toml when you work in this project.",
+        "Keep AGENTS.md as the primary project instruction file.",
+        "NOTE: Trellis's SessionStart + UserPromptSubmit hooks require opt-in.",
+        "Add the following to your USER-level config at ~/.codex/config.toml",
+        "(not this project file — features.* must be enabled globally):",
+        "[features]",
+        "hooks = true",
+        "codex_hooks = true",
+        "Without this flag, hooks.json is ignored and Trellis context won't",
+        "be injected into Codex sessions.",
+    ];
+    // A comment line is "trellis-known" if its content (after `#` and spaces)
+    // matches one of the known marker strings exactly OR is an empty `#` line.
+    function isTrellisCommentLine(line) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("#"))
+            return false;
+        const inner = trimmed.replace(/^#+\s?/, "").trim();
+        if (inner.length === 0)
+            return true; // bare `#` line inside trellis block
+        return trellisCommentMarkers.some((m) => inner === m);
+    }
+    function isTrellisAssignment(line) {
+        return /^\s*project_doc_fallback_filenames\s*=/.test(line);
+    }
+    const out = [];
+    let prevWasBlank = true; // start-of-file counts as blank for collapsing
+    for (const rawLine of content.split(/\r?\n/)) {
+        if (isTrellisAssignment(rawLine) || isTrellisCommentLine(rawLine)) {
+            continue; // drop
+        }
+        const isBlank = rawLine.trim().length === 0;
+        if (isBlank && prevWasBlank) {
+            continue; // collapse runs of blanks created by removals
+        }
+        out.push(rawLine);
+        prevWasBlank = isBlank;
+    }
+    // Trim trailing blank lines.
+    while (out.length > 0 && out[out.length - 1].trim().length === 0) {
+        out.pop();
+    }
+    const result = out.length > 0 ? out.join("\n") + "\n" : "";
+    const fullyEmpty = result.trim().length === 0;
+    return { content: result, fullyEmpty };
+}
+//# sourceMappingURL=uninstall-scrubbers.js.map

package/dist/utils/uninstall-scrubbers.js.map

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

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

@@ -0,0 +1,86 @@
+/**
+ * Workflow template resolver.
+ *
+ * Centralizes how `trellis init --workflow` and `trellis 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 Trellis-managed for hash-tracking: when this id is selected by
+ * `init --workflow` or `trellis workflow`, `.trellis/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:trellis/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"}