faceted-prompting 0.0.0 → 0.2.0

package/dist/scope.js

@@ -0,0 +1,69 @@
+/**
+ * @scope reference resolution utilities for TAKT repertoire packages.
+ *
+ * Provides:
+ * - isScopeRef(): detect @{owner}/{repo}/{facet-name} format
+ * - parseScopeRef(): parse and normalize components
+ * - resolveScopeRef(): build file path in repertoire directory
+ * - validateScopeOwner/Repo/FacetName(): name constraint validation
+ */
+import { join } from 'node:path';
+/** Matches @{owner}/{repo}/{facet-name} format. */
+const SCOPE_REF_PATTERN = /^@[^/]+\/[^/]+\/[^/]+$/;
+/**
+ * Return true if the string is an @{owner}/{repo}/{facet-name} scope reference.
+ */
+export function isScopeRef(ref) {
+    return SCOPE_REF_PATTERN.test(ref);
+}
+/**
+ * Parse an @scope reference into its components.
+ * Normalizes owner and repo to lowercase.
+ *
+ * @param ref - e.g. "@nrslib/takt-fullstack/expert-coder"
+ */
+export function parseScopeRef(ref) {
+    const withoutAt = ref.slice(1);
+    const firstSlash = withoutAt.indexOf('/');
+    const owner = withoutAt.slice(0, firstSlash).toLowerCase();
+    const rest = withoutAt.slice(firstSlash + 1);
+    const secondSlash = rest.indexOf('/');
+    const repo = rest.slice(0, secondSlash).toLowerCase();
+    const name = rest.slice(secondSlash + 1);
+    validateScopeOwner(owner);
+    validateScopeRepo(repo);
+    validateScopeFacetName(name);
+    return { owner, repo, name };
+}
+/**
+ * Resolve a scope reference to a file path in the repertoire directory.
+ *
+ * Path: {repertoireDir}/@{owner}/{repo}/facets/{facetType}/{name}.md
+ *
+ * @param scopeRef      - parsed scope reference
+ * @param facetType     - e.g. "personas", "policies", "knowledge"
+ * @param repertoireDir - root repertoire directory (e.g. ~/.takt/repertoire)
+ * @returns Absolute path to the facet file.
+ */
+export function resolveScopeRef(scopeRef, facetType, repertoireDir) {
+    return join(repertoireDir, `@${scopeRef.owner}`, scopeRef.repo, 'facets', facetType, `${scopeRef.name}.md`);
+}
+/** Validate owner name: must match /^[a-z0-9][a-z0-9-]*$/ */
+export function validateScopeOwner(owner) {
+    if (!/^[a-z0-9][a-z0-9-]*$/.test(owner)) {
+        throw new Error(`Invalid scope owner: "${owner}". Must match /^[a-z0-9][a-z0-9-]*$/ (lowercase alphanumeric and hyphens, not starting with hyphen).`);
+    }
+}
+/** Validate repo name: must match /^[a-z0-9][a-z0-9._-]*$/ */
+export function validateScopeRepo(repo) {
+    if (!/^[a-z0-9][a-z0-9._-]*$/.test(repo)) {
+        throw new Error(`Invalid scope repo: "${repo}". Must match /^[a-z0-9][a-z0-9._-]*$/ (lowercase alphanumeric, hyphens, dots, underscores, not starting with hyphen).`);
+    }
+}
+/** Validate facet name: must match /^[a-z0-9][a-z0-9-]*$/ */
+export function validateScopeFacetName(name) {
+    if (!/^[a-z0-9][a-z0-9-]*$/.test(name)) {
+        throw new Error(`Invalid scope facet name: "${name}". Must match /^[a-z0-9][a-z0-9-]*$/ (lowercase alphanumeric and hyphens, not starting with hyphen).`);
+    }
+}
+//# sourceMappingURL=scope.js.map

package/dist/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAYjC,mDAAmD;AACnD,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AAEnD;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3D,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;IACzC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC1B,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACxB,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAkB,EAClB,SAAiB,EACjB,aAAqB;IAErB,OAAO,IAAI,CACT,aAAa,EACb,IAAI,QAAQ,CAAC,KAAK,EAAE,EACpB,QAAQ,CAAC,IAAI,EACb,QAAQ,EACR,SAAS,EACT,GAAG,QAAQ,CAAC,IAAI,KAAK,CACtB,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,yBAAyB,KAAK,sGAAsG,CACrI,CAAC;IACJ,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,wHAAwH,CACrJ,CAAC;IACJ,CAAC;AACH,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,8BAA8B,IAAI,sGAAsG,CACzI,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/template.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Minimal template engine for Markdown prompt templates.
+ *
+ * Supports:
+ * - {{#if variable}}...{{else}}...{{/if}} conditional blocks (no nesting)
+ * - {{variableName}} substitution
+ *
+ * This module has ZERO dependencies on TAKT internals.
+ */
+/**
+ * Process {{#if variable}}...{{else}}...{{/if}} conditional blocks.
+ *
+ * A variable is truthy when it is a non-empty string or boolean true.
+ * Nesting is NOT supported.
+ */
+export declare function processConditionals(template: string, vars: Record<string, string | boolean>): string;
+/**
+ * Replace {{variableName}} placeholders with values from vars.
+ * Undefined or false variables are replaced with empty string.
+ * True is replaced with the string "true".
+ */
+export declare function substituteVariables(template: string, vars: Record<string, string | boolean>): string;
+/**
+ * Render a template string by processing conditionals then substituting variables.
+ */
+export declare function renderTemplate(template: string, vars: Record<string, string | boolean>): string;
+//# sourceMappingURL=template.d.ts.map

package/dist/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GACrC,MAAM,CAcR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GACrC,MAAM,CAUR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GACrC,MAAM,CAGR"}

package/dist/template.js

@@ -0,0 +1,49 @@
+/**
+ * Minimal template engine for Markdown prompt templates.
+ *
+ * Supports:
+ * - {{#if variable}}...{{else}}...{{/if}} conditional blocks (no nesting)
+ * - {{variableName}} substitution
+ *
+ * This module has ZERO dependencies on TAKT internals.
+ */
+/**
+ * Process {{#if variable}}...{{else}}...{{/if}} conditional blocks.
+ *
+ * A variable is truthy when it is a non-empty string or boolean true.
+ * Nesting is NOT supported.
+ */
+export function processConditionals(template, vars) {
+    return template.replace(/\{\{#if\s+(\w+)\}\}([\s\S]*?)\{\{\/if\}\}/g, (_match, varName, body) => {
+        const value = vars[varName];
+        const isTruthy = value !== undefined && value !== false && value !== '';
+        const elseIndex = body.indexOf('{{else}}');
+        if (isTruthy) {
+            return elseIndex >= 0 ? body.slice(0, elseIndex) : body;
+        }
+        return elseIndex >= 0 ? body.slice(elseIndex + '{{else}}'.length) : '';
+    });
+}
+/**
+ * Replace {{variableName}} placeholders with values from vars.
+ * Undefined or false variables are replaced with empty string.
+ * True is replaced with the string "true".
+ */
+export function substituteVariables(template, vars) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_match, varName) => {
+        const value = vars[varName];
+        if (value === undefined || value === false)
+            return '';
+        if (value === true)
+            return 'true';
+        return value;
+    });
+}
+/**
+ * Render a template string by processing conditionals then substituting variables.
+ */
+export function renderTemplate(template, vars) {
+    const afterConditionals = processConditionals(template, vars);
+    return substituteVariables(afterConditionals, vars);
+}
+//# sourceMappingURL=template.js.map

package/dist/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,IAAsC;IAEtC,OAAO,QAAQ,CAAC,OAAO,CACrB,4CAA4C,EAC5C,CAAC,MAAM,EAAE,OAAe,EAAE,IAAY,EAAU,EAAE;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,EAAE,CAAC;QAExE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1D,CAAC;QACD,OAAO,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,IAAsC;IAEtC,OAAO,QAAQ,CAAC,OAAO,CACrB,gBAAgB,EAChB,CAAC,MAAM,EAAE,OAAe,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK;YAAE,OAAO,EAAE,CAAC;QACtD,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,IAAsC;IAEtC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC9D,OAAO,mBAAmB,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC"}

package/dist/truncation.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Context truncation for knowledge and policy facets.
+ *
+ * When facet content exceeds a character limit, it is trimmed and
+ * annotated with source-path metadata so the LLM can consult the
+ * original file.
+ *
+ * This module has ZERO dependencies on TAKT internals.
+ */
+interface PreparedContextBlock {
+    readonly content: string;
+    readonly truncated: boolean;
+}
+/**
+ * Trim content to a maximum character length, appending a
+ * "...TRUNCATED..." marker when truncation occurs.
+ */
+export declare function trimContextContent(content: string, maxChars: number): PreparedContextBlock;
+/**
+ * Standard notice appended to knowledge and policy blocks.
+ */
+export declare function renderConflictNotice(): string;
+/**
+ * Prepare a knowledge facet for inclusion in a prompt.
+ *
+ * Trims to maxChars, appends truncation notice and source path if available.
+ */
+export declare function prepareKnowledgeContent(content: string, maxChars: number, sourcePath?: string): string;
+/**
+ * Prepare a policy facet for inclusion in a prompt.
+ *
+ * Trims to maxChars, appends authoritative-source notice and source path if available.
+ */
+export declare function preparePolicyContent(content: string, maxChars: number, sourcePath?: string): string;
+export {};
+//# sourceMappingURL=truncation.d.ts.map

package/dist/truncation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncation.d.ts","sourceRoot":"","sources":["../src/truncation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,oBAAoB,CAQtB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAcR;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAcR"}

package/dist/truncation.js

@@ -0,0 +1,63 @@
+/**
+ * Context truncation for knowledge and policy facets.
+ *
+ * When facet content exceeds a character limit, it is trimmed and
+ * annotated with source-path metadata so the LLM can consult the
+ * original file.
+ *
+ * This module has ZERO dependencies on TAKT internals.
+ */
+/**
+ * Trim content to a maximum character length, appending a
+ * "...TRUNCATED..." marker when truncation occurs.
+ */
+export function trimContextContent(content, maxChars) {
+    if (content.length <= maxChars) {
+        return { content, truncated: false };
+    }
+    return {
+        content: `${content.slice(0, maxChars)}\n...TRUNCATED...`,
+        truncated: true,
+    };
+}
+/**
+ * Standard notice appended to knowledge and policy blocks.
+ */
+export function renderConflictNotice() {
+    return 'If prompt content conflicts with source files, source files take precedence.';
+}
+/**
+ * Prepare a knowledge facet for inclusion in a prompt.
+ *
+ * Trims to maxChars, appends truncation notice and source path if available.
+ */
+export function prepareKnowledgeContent(content, maxChars, sourcePath) {
+    const prepared = trimContextContent(content, maxChars);
+    const lines = [prepared.content];
+    if (prepared.truncated && sourcePath) {
+        lines.push('', `Knowledge is truncated. You MUST consult the source files before making decisions. Source: ${sourcePath}`);
+    }
+    if (sourcePath) {
+        lines.push('', `Knowledge Source: ${sourcePath}`);
+    }
+    lines.push('', renderConflictNotice());
+    return lines.join('\n');
+}
+/**
+ * Prepare a policy facet for inclusion in a prompt.
+ *
+ * Trims to maxChars, appends authoritative-source notice and source path if available.
+ */
+export function preparePolicyContent(content, maxChars, sourcePath) {
+    const prepared = trimContextContent(content, maxChars);
+    const lines = [prepared.content];
+    if (prepared.truncated && sourcePath) {
+        lines.push('', `Policy is authoritative. If truncated, you MUST read the full policy file and follow it strictly. Source: ${sourcePath}`);
+    }
+    if (sourcePath) {
+        lines.push('', `Policy Source: ${sourcePath}`);
+    }
+    lines.push('', renderConflictNotice());
+    return lines.join('\n');
+}
+//# sourceMappingURL=truncation.js.map

package/dist/truncation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncation.js","sourceRoot":"","sources":["../src/truncation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,QAAgB;IAEhB,IAAI,OAAO,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC/B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACvC,CAAC;IACD,OAAO;QACL,OAAO,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,mBAAmB;QACzD,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,8EAA8E,CAAC;AACxF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,QAAgB,EAChB,UAAmB;IAEnB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,KAAK,GAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,QAAQ,CAAC,SAAS,IAAI,UAAU,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CACR,EAAE,EACF,8FAA8F,UAAU,EAAE,CAC3G,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,qBAAqB,UAAU,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,oBAAoB,EAAE,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,QAAgB,EAChB,UAAmB;IAEnB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,KAAK,GAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,QAAQ,CAAC,SAAS,IAAI,UAAU,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CACR,EAAE,EACF,6GAA6G,UAAU,EAAE,CAC1H,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,kBAAkB,UAAU,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,oBAAoB,EAAE,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Core type definitions for Faceted Prompting.
+ *
+ * Defines the vocabulary of facets (persona, policy, knowledge, instruction,
+ * output-contract) and the structures used by compose() and DataEngine.
+ *
+ * This module has ZERO dependencies on TAKT internals.
+ */
+/** Plural directory names used in facet resolution. */
+export type FacetKind = 'personas' | 'policies' | 'knowledge' | 'instructions' | 'output-contracts';
+/** A single piece of facet content with optional metadata. */
+export interface FacetContent {
+    /** Raw text body of the facet. */
+    readonly body: string;
+    /** Filesystem path the content was loaded from, if applicable. */
+    readonly sourcePath?: string;
+}
+/**
+ * A complete set of resolved facet contents to be composed.
+ *
+ * All fields are optional — a FacetSet may contain only a subset of facets.
+ */
+export interface FacetSet {
+    readonly persona?: FacetContent;
+    readonly policies?: readonly FacetContent[];
+    readonly knowledge?: readonly FacetContent[];
+    readonly instruction?: FacetContent;
+}
+/**
+ * The output of compose(): facet content assigned to LLM message slots.
+ *
+ * persona → systemPrompt
+ * policy + knowledge + instruction → userMessage
+ */
+export interface ComposedPrompt {
+    readonly systemPrompt: string;
+    readonly userMessage: string;
+}
+export interface CopyFiles {
+    readonly persona: readonly string[];
+    readonly knowledge: readonly string[];
+    readonly policies: readonly string[];
+    readonly instructions: readonly string[];
+}
+export interface ComposedPromptPayload {
+    readonly systemPrompt: string;
+    readonly userPrompt: string;
+    readonly copyFiles: CopyFiles;
+}
+/** User-message sections that can be ordered in compose definitions. */
+export type ComposeOrderEntry = 'policies' | 'knowledge' | 'instruction';
+/** CLI compose definition loaded from YAML. */
+export interface ComposeDefinition {
+    readonly name: string;
+    readonly description?: string;
+    readonly persona: string;
+    readonly template?: string;
+    readonly knowledge?: readonly string[];
+    readonly policies?: readonly string[];
+    readonly instruction?: string;
+    readonly order?: readonly ComposeOrderEntry[];
+}
+/** Options controlling compose() behaviour. */
+export interface ComposeOptions {
+    /** Maximum character length for knowledge/policy content before truncation. */
+    readonly contextMaxChars: number;
+    /** Optional user-message section order for policies/knowledge/instruction. */
+    readonly userMessageOrder?: readonly ComposeOrderEntry[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,uDAAuD;AACvD,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,UAAU,GACV,WAAW,GACX,cAAc,GACd,kBAAkB,CAAC;AAEvB,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC;CACrC;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED,wEAAwE;AACxE,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,CAAC;AAEzE,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC/C;AAED,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC1D"}

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * Core type definitions for Faceted Prompting.
+ *
+ * Defines the vocabulary of facets (persona, policy, knowledge, instruction,
+ * output-contract) and the structures used by compose() and DataEngine.
+ *
+ * This module has ZERO dependencies on TAKT internals.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/package.json

@@ -1,11 +1,54 @@
 {
   "name": "faceted-prompting",
-  "version": "0.0.0",
-  "description": "Faceted Prompting - A design pattern for composing structured AI prompts from multiple facets (persona, policy, knowledge, instruction)",
-  "author": "nrslib",
+  "version": "0.2.0",
+  "description": "Faceted Prompting — structured prompt composition for LLMs",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "facet": "./bin/facet"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin/facet"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "test": "npm run test:unit",
+    "test:unit": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest",
+    "test:e2e": "tmp=\"$(mktemp -t faceted-prompting-e2e.XXXXXX)\"; mkdir -p e2e/results; npm run test:e2e:cli >\"$tmp\" 2>&1; code=$?; cat \"$tmp\"; rm -f \"$tmp\"; if [ \"$code\" -eq 0 ]; then msg='test:e2e passed'; else msg=\"test:e2e failed (exit=$code)\"; fi; if command -v osascript >/dev/null 2>&1; then osascript -e \"display notification \\\"$msg\\\" with title \\\"faceted-prompting\\\" subtitle \\\"E2E\\\"\" >/dev/null 2>&1 || true; fi; echo \"[faceted-prompting] $msg\"; exit $code",
+    "test:e2e:cli": "vitest run --config vitest.config.e2e.ts --outputFile.json=e2e/results/cli.json",
+    "lint": "eslint src/",
+    "check:release": "npm run build && npm run lint && npm run test:unit && npm run test:e2e; code=$?; if [ \"$code\" -eq 0 ]; then msg='check:release passed'; else msg=\"check:release failed (exit=$code)\"; fi; if command -v osascript >/dev/null 2>&1; then osascript -e \"display notification \\\"$msg\\\" with title \\\"faceted-prompting\\\" subtitle \\\"Release Check\\\"\" >/dev/null 2>&1 || true; fi; echo \"[faceted-prompting] $msg\"; exit $code",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "keywords": [
+    "prompt",
+    "llm",
+    "faceted-prompting",
+    "prompt-engineering",
+    "ai"
+  ],
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/nrslib/faceted-prompting"
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.11",
+    "eslint": "^9.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "traced-config": "^0.1.0",
+    "yaml": "^2.8.1"
   }
 }