pi-template-kit

Shared LiquidJS prompt-template toolkit for Pi packages.

Why

grounded-compaction and pi-prompt-composer both grew local Liquid engines:

• same engine defaults
• overlapping filters
• incompatible {% xml %} implementations
• duplicated frontmatter/template loading logic

pi-template-kit is the small library that owns that shared layer. It does not own pi-loom host orchestration, system prompt graph policy, reminders, provider payloads, or custom-message registries.

Package surfaces

Import	Purpose
pi-template-kit/liquid	createEngine, filters, native {% xml %} tag
pi-template-kit/template	loadTemplate, loadTemplateFromString, frontmatter + partial/layout roots
pi-template-kit	re-exports both surfaces

Example

import { loadTemplate } from 'pi-template-kit/template';

const template = await loadTemplate('compaction-prompt.md');
const out = template.render({ focus: 'ship it' });

The {% xml %} tag

Wraps a block in an XML element, and emits nothing when the body is empty — so an optional prompt section needs no surrounding {% if %}.

{% xml "focus" %}{{ focus }}{% endxml %}

<focus>
ship it
</focus>

Attributes

Optional key:value pairs after the tag name. Values are Liquid expressions or quoted literals, parsed by Liquid's own Hash — the same grammar {% for %} uses.

{% xml "files-touched" cwd:cwd mode:"strict" %}{{ manifest }}{% endxml %}

<files-touched cwd="/Users/v/project" mode="strict">
…manifest…
</files-touched>

• key:value, not key=value. The equals form is Liquid's bare-flag spelling and binds true, so cwd=cwd emits cwd="true" — a wrong value rather than an error. Use the colon.
• Nil and empty values are omitted, so passing an optional variable unguarded yields <files-touched> rather than cwd="".
• Values are XML-escaped (&, <, >, ").
• An empty body still emits nothing, attributes notwithstanding.

Ownership split

Package	Owns
pi-template-kit	Liquid engine, shared filters, {% xml %} tag, file template loader
pi-loom	prompt graph, system reminders, host coordinator, provider handoff metadata
pi-prompt-composer	grouped prompt discovery, arg collection, shell block policy
grounded-compaction	compaction render variables, summary workflow, examples
pi-prompt-core	legacy messages registry until consumers migrate; no new template/system-prompt work

Development

pnpm install
pnpm run check

License

MIT