faceted-prompting 0.0.0 → 0.2.0

package/dist/cli/install-skill/facets.js

@@ -0,0 +1,160 @@
+import { basename, join } from 'node:path';
+import { copyFileSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+const FACET_TOKEN_PATTERN = /{{facet:(persona|knowledges|policies|instructions)}}/g;
+const FACET_TOKEN_TEST = /{{facet:(persona|knowledges|policies|instructions)}}/;
+function requireFacetPathCount(params) {
+    if (params.expected !== params.actual) {
+        throw new Error(`Copied ${params.label} facet count mismatch: expected ${params.expected}, received ${params.actual}`);
+    }
+}
+function requireFacetPathAtIndex(params) {
+    const path = params.paths[params.index];
+    if (path === undefined) {
+        throw new Error(`Missing copied ${params.label} facet path at index ${params.index}`);
+    }
+    return path;
+}
+function normalizeInstructionBody(body) {
+    return body.endsWith('\n') ? body : `${body}\n`;
+}
+export function buildInlineFacetTokenValues(sections) {
+    return {
+        persona: sections.persona.body,
+        knowledges: sections.knowledge.map(knowledge => knowledge.body).join('\n'),
+        policies: sections.policies.map(policy => policy.body).join('\n'),
+        instructions: sections.instruction ? sections.instruction.body : '',
+    };
+}
+function replaceFacetTokens(content, values) {
+    return content.replaceAll(FACET_TOKEN_PATTERN, (_match, token) => {
+        return values[token];
+    });
+}
+export function buildSectionsWithCopiedPaths(sections, facets) {
+    requireFacetPathCount({
+        label: 'knowledge',
+        expected: sections.knowledge.length,
+        actual: facets.knowledges.length,
+    });
+    requireFacetPathCount({
+        label: 'policy',
+        expected: sections.policies.length,
+        actual: facets.policies.length,
+    });
+    const instruction = sections.instruction && facets.instructions
+        ? {
+            ref: basename(facets.instructions, '.md'),
+            body: sections.instruction.body,
+            path: facets.instructions,
+        }
+        : sections.instruction;
+    return {
+        ...sections,
+        persona: {
+            ...sections.persona,
+            path: facets.persona,
+        },
+        knowledge: sections.knowledge.map((knowledge, index) => ({
+            ...knowledge,
+            path: requireFacetPathAtIndex({
+                label: 'knowledge',
+                paths: facets.knowledges,
+                index,
+            }),
+        })),
+        policies: sections.policies.map((policy, index) => ({
+            ...policy,
+            path: requireFacetPathAtIndex({
+                label: 'policy',
+                paths: facets.policies,
+                index,
+            }),
+        })),
+        instruction,
+    };
+}
+export function copyFacetFiles(params) {
+    const facetsDir = join(params.targetDir, 'facets');
+    const personaDir = join(facetsDir, 'persona');
+    const knowledgeDir = join(facetsDir, 'knowledge');
+    const policiesDir = join(facetsDir, 'policies');
+    const instructionsDir = join(facetsDir, 'instructions');
+    mkdirSync(personaDir, { recursive: true });
+    mkdirSync(knowledgeDir, { recursive: true });
+    mkdirSync(policiesDir, { recursive: true });
+    const sourcePersonaPath = params.copyFiles.persona[0];
+    if (!sourcePersonaPath) {
+        throw new Error('Missing persona copy file path');
+    }
+    const personaPath = join(personaDir, basename(sourcePersonaPath));
+    copyFileSync(sourcePersonaPath, personaPath);
+    const knowledgePaths = params.copyFiles.knowledge.map(path => {
+        const targetPath = join(knowledgeDir, basename(path));
+        copyFileSync(path, targetPath);
+        return targetPath;
+    });
+    const policyPaths = params.copyFiles.policies.map(path => {
+        const targetPath = join(policiesDir, basename(path));
+        copyFileSync(path, targetPath);
+        return targetPath;
+    });
+    let instructionPath;
+    const sourceInstructionPath = params.copyFiles.instructions[0];
+    if (sourceInstructionPath || params.literalInstructionBody) {
+        mkdirSync(instructionsDir, { recursive: true });
+        if (sourceInstructionPath) {
+            instructionPath = join(instructionsDir, basename(sourceInstructionPath));
+            copyFileSync(sourceInstructionPath, instructionPath);
+        }
+        else {
+            instructionPath = join(instructionsDir, `${params.safeSkillName}.md`);
+            writeFileSync(instructionPath, normalizeInstructionBody(params.literalInstructionBody ?? ''), 'utf-8');
+        }
+    }
+    return {
+        persona: personaPath,
+        knowledges: knowledgePaths,
+        policies: policyPaths,
+        instructions: instructionPath,
+    };
+}
+export function applyFacetTokensToPath(params) {
+    const { rootDir, maxDepth, tokenValues, excludeDirs } = params;
+    const visit = (currentDir, depth) => {
+        for (const entry of readdirSync(currentDir, { withFileTypes: true })) {
+            if (entry.isSymbolicLink()) {
+                continue;
+            }
+            const entryPath = join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                if (currentDir === rootDir && excludeDirs.includes(entry.name)) {
+                    continue;
+                }
+                if (depth < maxDepth) {
+                    visit(entryPath, depth + 1);
+                }
+                continue;
+            }
+            if (!entry.isFile()) {
+                continue;
+            }
+            const original = readFileSync(entryPath, 'utf-8');
+            if (!FACET_TOKEN_TEST.test(original)) {
+                continue;
+            }
+            const replaced = replaceFacetTokens(original, tokenValues);
+            if (replaced !== original) {
+                writeFileSync(entryPath, replaced, 'utf-8');
+            }
+        }
+    };
+    visit(rootDir, 0);
+}
+export function parseScanDepth(rawDepth) {
+    const parsed = Number.parseInt(rawDepth, 10);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        throw new Error(`Invalid scan depth: ${rawDepth}`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=facets.js.map

package/dist/cli/install-skill/facets.js.map

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

package/dist/cli/install-skill/flow.d.ts

@@ -0,0 +1,13 @@
+import type { FacetCliOptions } from '../types.js';
+export { defaultOutputPath, listInstallTargets, resolveInstallTarget } from './targets.js';
+export declare function shouldOverwrite(answer: string): boolean;
+export declare function ensureTemplateDirectory(facetedRoot: string, templateName: string): string;
+export declare function copyDirectoryTree(sourceDir: string, targetDir: string): void;
+export declare function ensureRegenerationTargetDir(params: {
+    targetDir: string;
+    options: FacetCliOptions;
+    promptLabel: string;
+    homeDir?: string;
+}): Promise<void>;
+export declare function ensureDirectoryExists(path: string, label: string): void;
+//# sourceMappingURL=flow.d.ts.map

package/dist/cli/install-skill/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../../src/cli/install-skill/flow.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAE3F,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAazF;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAoB5E;AAgBD,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIvE"}

package/dist/cli/install-skill/flow.js

@@ -0,0 +1,63 @@
+import { copyFileSync, existsSync, lstatSync, mkdirSync, readdirSync, rmSync, } from 'node:fs';
+import { join } from 'node:path';
+import { ensurePathAncestorsAndRealPathWithinHome, ensurePathAncestorsContainNoSymbolicLinks, ensurePathWithinRoots, } from '../path-guard.js';
+export { defaultOutputPath, listInstallTargets, resolveInstallTarget } from './targets.js';
+export function shouldOverwrite(answer) {
+    const normalized = answer.trim().toLowerCase();
+    return normalized === 'y' || normalized === 'yes';
+}
+export function ensureTemplateDirectory(facetedRoot, templateName) {
+    const templatesRoot = join(facetedRoot, 'templates');
+    const templatePath = ensurePathWithinRoots(join(templatesRoot, templateName), [templatesRoot], `template "${templateName}"`);
+    if (!lstatSync(templatePath).isDirectory()) {
+        throw new Error(`Template path must be a directory: ${templatePath}`);
+    }
+    return templatePath;
+}
+export function copyDirectoryTree(sourceDir, targetDir) {
+    mkdirSync(targetDir, { recursive: true });
+    for (const entry of readdirSync(sourceDir, { withFileTypes: true })) {
+        if (entry.isSymbolicLink()) {
+            throw new Error(`Symbolic links are not allowed in template directory: ${join(sourceDir, entry.name)}`);
+        }
+        const sourcePath = join(sourceDir, entry.name);
+        const targetPath = join(targetDir, entry.name);
+        if (entry.isDirectory()) {
+            copyDirectoryTree(sourcePath, targetPath);
+            continue;
+        }
+        if (entry.isFile()) {
+            copyFileSync(sourcePath, targetPath);
+        }
+    }
+}
+function ensurePathSafety(params) {
+    if (params.homeDir) {
+        ensurePathAncestorsAndRealPathWithinHome(params.targetDir, params.homeDir, params.promptLabel);
+        return;
+    }
+    ensurePathAncestorsContainNoSymbolicLinks(params.targetDir, params.promptLabel, params.cwd);
+}
+export async function ensureRegenerationTargetDir(params) {
+    const { targetDir, options, promptLabel } = params;
+    ensurePathSafety({
+        targetDir,
+        promptLabel,
+        homeDir: params.homeDir,
+        cwd: options.cwd,
+    });
+    if (existsSync(targetDir)) {
+        const overwriteAnswer = await options.input(`${promptLabel} exists. Replace? (${targetDir}) [y/N]`, 'n');
+        if (!shouldOverwrite(overwriteAnswer)) {
+            throw new Error(`${promptLabel} exists and overwrite was cancelled: ${targetDir}`);
+        }
+        rmSync(targetDir, { recursive: true, force: true });
+    }
+    mkdirSync(targetDir, { recursive: true });
+}
+export function ensureDirectoryExists(path, label) {
+    if (!existsSync(path) || !lstatSync(path).isDirectory()) {
+        throw new Error(`${label} does not exist: ${path}`);
+    }
+}
+//# sourceMappingURL=flow.js.map

package/dist/cli/install-skill/flow.js.map

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

package/dist/cli/install-skill/modes.d.ts

@@ -0,0 +1,27 @@
+import type { FacetCliOptions, FacetCliResult } from '../types.js';
+import type { SkillSections } from './facets.js';
+import type { ComposeDefinition } from '../../types.js';
+import type { InstallTarget } from '../skill-types.js';
+export declare function runTemplateApplyInstall(params: {
+    options: FacetCliOptions;
+    safeSkillName: string;
+    sections: SkillSections;
+    templateDir: string;
+    definitionDir: string;
+    facetsRoot: string;
+}): Promise<FacetCliResult>;
+export declare function runSkillDeployInstall(params: {
+    options: FacetCliOptions;
+    facetedRoot: string;
+    definitionDir: string;
+    facetsRoot: string;
+    safeSkillName: string;
+    definition: ComposeDefinition;
+    sections: SkillSections;
+}): Promise<{
+    result: FacetCliResult;
+    mode: 'inline';
+    outputPath: string;
+    target: InstallTarget;
+}>;
+//# sourceMappingURL=modes.d.ts.map

package/dist/cli/install-skill/modes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../../src/cli/install-skill/modes.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAgBnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAqBvD,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,OAAO,EAAE,eAAe,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2C1B;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,EAAE,aAAa,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC,CA0FjG"}

package/dist/cli/install-skill/modes.js

@@ -0,0 +1,130 @@
+import { existsSync, lstatSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { ensurePathWithinHome } from '../path-guard.js';
+import { hasYamlFrontmatter, renderSkillDocument, renderSkillFrontmatter } from '../skill-renderer.js';
+import { writeSkillFile } from '../skill-file-ops.js';
+import { applyFacetTokensToPath, buildInlineFacetTokenValues, copyFacetFiles, parseScanDepth, } from './facets.js';
+import { copyDirectoryTree, defaultOutputPath, ensureDirectoryExists, ensureRegenerationTargetDir, listInstallTargets, ensureTemplateDirectory, resolveInstallTarget, } from './flow.js';
+import { composePromptPayload } from '../../prompt-payload.js';
+function ensureTemplateBackedSkillFrontmatter(params) {
+    if (!existsSync(params.outputPath)) {
+        return;
+    }
+    const currentContent = readFileSync(params.outputPath, 'utf-8');
+    if (hasYamlFrontmatter(currentContent)) {
+        return;
+    }
+    const contentWithFrontmatter = `${renderSkillFrontmatter(params.definition)}\n${currentContent.trimStart()}`;
+    writeSkillFile(params.outputPath, contentWithFrontmatter, params.homeDir);
+}
+export async function runTemplateApplyInstall(params) {
+    const requestedDir = await params.options.input('Output directory', params.options.cwd);
+    const targetDir = resolve(requestedDir);
+    ensureDirectoryExists(targetDir, 'Output directory');
+    const scanDepth = parseScanDepth(await params.options.input('Scan depth', '1'));
+    const payload = composePromptPayload({
+        definition: params.sections.definition,
+        definitionDir: params.definitionDir,
+        facetsRoot: params.facetsRoot,
+        composeOptions: { contextMaxChars: 8000 },
+    });
+    copyDirectoryTree(params.templateDir, targetDir);
+    const facetsDir = join(targetDir, 'facets');
+    await ensureRegenerationTargetDir({
+        targetDir: facetsDir,
+        options: params.options,
+        promptLabel: 'Facets directory',
+    });
+    const facetPaths = copyFacetFiles({
+        targetDir,
+        safeSkillName: params.safeSkillName,
+        copyFiles: payload.copyFiles,
+        literalInstructionBody: params.sections.instruction && !('path' in params.sections.instruction)
+            ? params.sections.instruction.body
+            : undefined,
+    });
+    applyFacetTokensToPath({
+        rootDir: targetDir,
+        maxDepth: scanDepth,
+        tokenValues: buildInlineFacetTokenValues(params.sections),
+        excludeDirs: ['facets'],
+    });
+    return {
+        kind: 'path',
+        path: targetDir,
+    };
+}
+export async function runSkillDeployInstall(params) {
+    const targetLabel = await params.options.select(listInstallTargets().map(target => target.label), 'Choose install target with Up/Down and Enter:');
+    const target = resolveInstallTarget(targetLabel);
+    const mode = 'inline';
+    const defaultPath = defaultOutputPath(params.options.homeDir, params.safeSkillName, target);
+    const outputPath = resolve(await params.options.input('Output path', defaultPath));
+    const { resolvedPath: boundedOutputPath } = ensurePathWithinHome(outputPath, params.options.homeDir, 'Skill output path');
+    if (existsSync(boundedOutputPath) && lstatSync(boundedOutputPath).isSymbolicLink()) {
+        throw new Error(`Symbolic links are not allowed for skill output file: ${boundedOutputPath}`);
+    }
+    const templateDir = params.definition.template
+        ? ensureTemplateDirectory(params.facetedRoot, params.definition.template)
+        : undefined;
+    const payload = composePromptPayload({
+        definition: params.definition,
+        definitionDir: params.definitionDir,
+        facetsRoot: params.facetsRoot,
+        composeOptions: { contextMaxChars: 8000 },
+    });
+    const targetDir = dirname(boundedOutputPath);
+    await ensureRegenerationTargetDir({
+        targetDir,
+        options: params.options,
+        promptLabel: 'Target directory',
+        homeDir: params.options.homeDir,
+    });
+    if (templateDir) {
+        copyDirectoryTree(templateDir, targetDir);
+        const facetPaths = copyFacetFiles({
+            targetDir,
+            safeSkillName: params.safeSkillName,
+            copyFiles: payload.copyFiles,
+            literalInstructionBody: params.sections.instruction && !('path' in params.sections.instruction)
+                ? params.sections.instruction.body
+                : undefined,
+        });
+        applyFacetTokensToPath({
+            rootDir: targetDir,
+            maxDepth: Number.MAX_SAFE_INTEGER,
+            tokenValues: buildInlineFacetTokenValues(params.sections),
+            excludeDirs: ['facets'],
+        });
+        ensureTemplateBackedSkillFrontmatter({
+            outputPath: boundedOutputPath,
+            definition: params.definition,
+            homeDir: params.options.homeDir,
+        });
+    }
+    else {
+        const copiedFacetPaths = copyFacetFiles({
+            targetDir,
+            safeSkillName: params.safeSkillName,
+            copyFiles: payload.copyFiles,
+            literalInstructionBody: params.sections.instruction && !('path' in params.sections.instruction)
+                ? params.sections.instruction.body
+                : undefined,
+        });
+        const content = renderSkillDocument({
+            ...params.sections,
+            mode,
+        });
+        writeSkillFile(boundedOutputPath, content, params.options.homeDir);
+    }
+    return {
+        result: {
+            kind: 'path',
+            path: boundedOutputPath,
+        },
+        mode,
+        outputPath: boundedOutputPath,
+        target: target.key,
+    };
+}
+//# sourceMappingURL=modes.js.map

package/dist/cli/install-skill/modes.js.map

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

package/dist/cli/install-skill/targets.d.ts

@@ -0,0 +1,10 @@
+import type { InstallTarget } from '../skill-types.js';
+export interface InstallTargetDefinition {
+    readonly key: InstallTarget;
+    readonly label: string;
+    readonly relativeOutputPath: readonly string[];
+}
+export declare function listInstallTargets(): readonly InstallTargetDefinition[];
+export declare function resolveInstallTarget(targetLabel: string): InstallTargetDefinition;
+export declare function defaultOutputPath(homeDir: string, skillName: string, target: InstallTargetDefinition): string;
+//# sourceMappingURL=targets.d.ts.map

package/dist/cli/install-skill/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../../src/cli/install-skill/targets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CAChD;AAeD,wBAAgB,kBAAkB,IAAI,SAAS,uBAAuB,EAAE,CAEvE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,uBAAuB,CAMjF;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,uBAAuB,GAC9B,MAAM,CAER"}

package/dist/cli/install-skill/targets.js

@@ -0,0 +1,27 @@
+import { join } from 'node:path';
+const INSTALL_TARGETS = [
+    {
+        key: 'cc',
+        label: 'Claude Code',
+        relativeOutputPath: ['.claude', 'skills'],
+    },
+    {
+        key: 'codex',
+        label: 'Codex',
+        relativeOutputPath: ['.codex', 'skills'],
+    },
+];
+export function listInstallTargets() {
+    return INSTALL_TARGETS;
+}
+export function resolveInstallTarget(targetLabel) {
+    const definition = INSTALL_TARGETS.find(candidate => candidate.label === targetLabel);
+    if (!definition) {
+        throw new Error(`Unsupported skill target: ${targetLabel}`);
+    }
+    return definition;
+}
+export function defaultOutputPath(homeDir, skillName, target) {
+    return join(homeDir, ...target.relativeOutputPath, skillName, 'SKILL.md');
+}
+//# sourceMappingURL=targets.js.map

package/dist/cli/install-skill/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../../src/cli/install-skill/targets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,MAAM,eAAe,GAAuC;IAC1D;QACE,GAAG,EAAE,IAAI;QACT,KAAK,EAAE,aAAa;QACpB,kBAAkB,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;KAC1C;IACD;QACE,GAAG,EAAE,OAAO;QACZ,KAAK,EAAE,OAAO;QACd,kBAAkB,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;KACzC;CACF,CAAC;AAEF,MAAM,UAAU,kBAAkB;IAChC,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC;IACtF,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,6BAA6B,WAAW,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,SAAiB,EACjB,MAA+B;IAE/B,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,kBAAkB,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAC5E,CAAC"}

package/dist/cli/path-guard.d.ts

@@ -0,0 +1,12 @@
+export declare function isWithinRoot(path: string, root: string): boolean;
+export declare function ensurePathWithinHome(path: string, homeDir: string, label: string): {
+    resolvedPath: string;
+    homeRealPath: string;
+};
+export declare function ensurePathWithinRoots(path: string, roots: readonly string[], label: string): string;
+export declare function ensurePathAncestorsContainNoSymbolicLinks(path: string, label: string, stopAtPath?: string): string;
+export declare function ensurePathAncestorsAndRealPathWithinHome(path: string, homeDir: string, label: string): {
+    resolvedPath: string;
+    homeRealPath: string;
+};
+//# sourceMappingURL=path-guard.d.ts.map

package/dist/cli/path-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-guard.d.ts","sourceRoot":"","sources":["../../src/cli/path-guard.ts"],"names":[],"mappings":"AAGA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAUhD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAqBnG;AAcD,wBAAgB,yCAAyC,CACvD,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CA4BR;AAED,wBAAgB,wCAAwC,CACtD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAYhD"}

package/dist/cli/path-guard.js

@@ -0,0 +1,81 @@
+import { existsSync, lstatSync, realpathSync } from 'node:fs';
+import { dirname, resolve, sep } from 'node:path';
+export function isWithinRoot(path, root) {
+    return path === root || path.startsWith(`${root}${sep}`);
+}
+export function ensurePathWithinHome(path, homeDir, label) {
+    const resolvedPath = resolve(path);
+    const resolvedHomeDir = resolve(homeDir);
+    const homeRealPath = realpathSync(resolvedHomeDir);
+    if (!isWithinRoot(resolvedPath, resolvedHomeDir)) {
+        throw new Error(`${label} must be inside home directory: ${resolvedPath}`);
+    }
+    return { resolvedPath, homeRealPath };
+}
+export function ensurePathWithinRoots(path, roots, label) {
+    const resolvedPath = resolve(path);
+    if (!existsSync(resolvedPath)) {
+        throw new Error(`Missing ${label}: ${resolvedPath}`);
+    }
+    const pathStat = lstatSync(resolvedPath);
+    if (pathStat.isSymbolicLink()) {
+        throw new Error(`Symbolic links are not allowed for ${label}: ${resolvedPath}`);
+    }
+    const realPath = realpathSync(resolvedPath);
+    for (const root of roots) {
+        const resolvedRoot = resolve(root);
+        const realRoot = existsSync(resolvedRoot) ? realpathSync(resolvedRoot) : resolvedRoot;
+        if (isWithinRoot(realPath, realRoot)) {
+            return realPath;
+        }
+    }
+    throw new Error(`${label} must be inside allowed facets directory: ${realPath}`);
+}
+function findNearestExistingAncestor(path) {
+    let current = path;
+    while (!existsSync(current)) {
+        const parent = dirname(current);
+        if (parent === current) {
+            throw new Error(`No existing ancestor found for path: ${path}`);
+        }
+        current = parent;
+    }
+    return current;
+}
+export function ensurePathAncestorsContainNoSymbolicLinks(path, label, stopAtPath) {
+    const resolvedPath = resolve(path);
+    const resolvedStopAtPath = stopAtPath ? resolve(stopAtPath) : undefined;
+    let current = resolvedPath;
+    while (true) {
+        if (resolvedStopAtPath && !isWithinRoot(current, resolvedStopAtPath)) {
+            break;
+        }
+        if (existsSync(current)) {
+            const stat = lstatSync(current);
+            if (stat.isSymbolicLink()) {
+                throw new Error(`Symbolic links are not allowed in ${label} path: ${current}`);
+            }
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            break;
+        }
+        if (resolvedStopAtPath && current === resolvedStopAtPath) {
+            break;
+        }
+        current = parent;
+    }
+    return resolvedPath;
+}
+export function ensurePathAncestorsAndRealPathWithinHome(path, homeDir, label) {
+    const { resolvedPath, homeRealPath } = ensurePathWithinHome(path, homeDir, label);
+    const resolvedHomeDir = resolve(homeDir);
+    ensurePathAncestorsContainNoSymbolicLinks(resolvedPath, label, resolvedHomeDir);
+    const existingAncestor = findNearestExistingAncestor(resolvedPath);
+    const ancestorRealPath = realpathSync(existingAncestor);
+    if (!isWithinRoot(ancestorRealPath, homeRealPath)) {
+        throw new Error(`${label} must resolve inside home directory: ${resolvedPath}`);
+    }
+    return { resolvedPath, homeRealPath };
+}
+//# sourceMappingURL=path-guard.js.map

package/dist/cli/path-guard.js.map

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

package/dist/cli/runner.d.ts

@@ -0,0 +1,10 @@
+import { runFacetCli } from './index.js';
+export interface RunnerDependencies {
+    readonly runFacetCli: typeof runFacetCli;
+    readonly writeStdout: (message: string) => void;
+    readonly writeStderr: (message: string) => void;
+    readonly setExitCode: (code: number) => void;
+}
+export declare function runMain(argv: string[], dependencies?: RunnerDependencies): Promise<void>;
+export declare function main(argv: string[]): Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/cli/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/cli/runner.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgBzC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,OAAO,WAAW,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAqBD,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,EAAE,EACd,YAAY,GAAE,kBAA0C,GACvD,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAExD"}