faceted-prompting 0.3.0 → 0.4.0

package/README.md

@@ -51,13 +51,13 @@ const result = compose(
     persona: { body: 'You are a senior TypeScript developer.' },
     policies: [{ body: 'Follow clean code principles. No any types.' }],
     knowledge: [{ body: 'The project uses Vitest for testing.' }],
-    instruction: { body: 'Implement a retry function with exponential backoff.' },
+    instructions: [{ body: 'Implement a retry function with exponential backoff.' }],
   },
   { contextMaxChars: 8000 },
 );
 
 // result.systemPrompt → "You are a senior TypeScript developer."
-// result.userMessage  → policies + knowledge + instruction (in order)
+// result.userMessage  → knowledge + instructions + policies (in order)
 ```
 
 ### As a CLI
@@ -88,6 +88,7 @@ facet install skill
 │   ├── persona/
 │   ├── knowledge/
 │   ├── policies/
+│   ├── instructions/
 │   └── compositions/
 └── templates/
 
@@ -97,6 +98,7 @@ facet install skill
 │   ├── persona/          # Persona Markdown files
 │   ├── knowledge/        # Domain knowledge files
 │   ├── policies/         # Policy/rules files
+│   ├── instructions/     # Instruction files
 │   └── compositions/     # Compose definition YAML files
 └── templates/            # Skill templates
 ```
@@ -125,16 +127,17 @@ knowledge:
   - architecture
 policies:
   - quality
-instruction: Summarize release impact.
+instructions:
+  - release-summary
 order:
   - knowledge
+  - instructions
   - policies
-  - instruction
 ```
 
 - `name` and `persona` are required.
-- `order` controls user-message section order (default: `policies` → `knowledge` → `instruction`).
-- `instruction` can be a facet file reference or inline text.
+- `order` controls user-message section order (default: `knowledge` → `instructions` → `policies`).
+- `instructions` is a list of facet names, file paths, or inline text.
 
 ## Scope References
 
@@ -201,6 +204,7 @@ See the [API Reference](./docs/api-reference.md) for the full API surface.
 │   ├── persona/
 │   ├── knowledge/
 │   ├── policies/
+│   ├── instructions/
 │   └── compositions/
 └── templates/
 
@@ -210,6 +214,7 @@ See the [API Reference](./docs/api-reference.md) for the full API surface.
 │   ├── persona/
 │   ├── knowledge/
 │   ├── policies/
+│   ├── instructions/
 │   └── compositions/
 ├── templates/                  # Skill install templates
 └── repertoire/                 # Installed repertoire packages

package/dist/cli/compose-command.d.ts

@@ -1,3 +1,3 @@
-import type { FacetCliOptions, FacetCliResult } from './types.js';
-export declare function runComposeCommand(options: FacetCliOptions): Promise<FacetCliResult>;
+import type { ComposeCliOptions, FacetCliOptions, FacetCliResult } from './types.js';
+export declare function runComposeCommand(options: FacetCliOptions, composeOptions: ComposeCliOptions): Promise<FacetCliResult>;
 //# sourceMappingURL=compose-command.d.ts.map

package/dist/cli/compose-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compose-command.d.ts","sourceRoot":"","sources":["../../src/cli/compose-command.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA8KlE,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA+BzF"}
+{"version":3,"file":"compose-command.d.ts","sourceRoot":"","sources":["../../src/cli/compose-command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAErF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,eAAe,EACxB,cAAc,EAAE,iBAAiB,GAChC,OAAO,CAAC,cAAc,CAAC,CAwBzB"}

package/dist/cli/compose-command.js

@@ -1,156 +1,26 @@
-import { existsSync, mkdirSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { compose } from '../compose.js';
-import { loadComposeDefinition } from '../compose-definition.js';
-import { formatCombinedOutput, resolveOutputDirectory, writeComposeOutput } from '../output/index.js';
-import { buildFacetSet, buildSkillSections, ensureSafeDefinitionName, } from './skill-renderer.js';
-import { getSkillPaths, selectCompositionDefinitionPath, } from './skill-commands.js';
-import { collectDirectoryFiles, copyDirectoryTree, ensureTemplateDirectoryFromRoots, shouldOverwrite, } from './install-skill/flow.js';
-import { applyFacetTokensToFiles, buildInlineFacetTokenValues } from './install-skill/facets.js';
-import { ensurePathAncestorsContainNoSymbolicLinks, ensurePathIsNotSymbolicLink } from './path-guard.js';
-function buildComposeOutputPlans(params) {
-    if (params.splitSystem) {
-        return [
-            {
-                fileName: `${params.safeName}.system.md`,
-                content: `${params.systemPrompt}\n`,
-            },
-            {
-                fileName: `${params.safeName}.user.md`,
-                content: `${params.userMessage}\n`,
-            },
-        ];
-    }
-    return [
-        {
-            fileName: `${params.safeName}.md`,
-            content: formatCombinedOutput({
-                systemPrompt: params.systemPrompt,
-                userMessage: params.userMessage,
-            }),
-        },
-    ];
-}
-async function confirmOverwriteForExistingPaths(params) {
-    if (params.existingPaths.length === 0) {
-        return false;
-    }
-    const overwriteAnswer = await params.options.input(`${params.promptMessage} (${params.existingPaths.join(', ')}) [y/N]`, 'n');
-    if (!shouldOverwrite(overwriteAnswer)) {
-        throw new Error(`${params.cancelMessage}: ${params.existingPaths.join(', ')}`);
-    }
-    return true;
-}
-async function runTemplateBackedCompose(params) {
-    const templateName = params.definition.template;
-    if (!templateName) {
-        throw new Error(`Template-backed compose requires template: ${params.definition.name}`);
-    }
-    const templateDir = ensureTemplateDirectoryFromRoots(params.facetedRoots, templateName);
-    const outputInput = await params.options.input('Output directory', params.options.cwd);
-    const outputDir = resolveOutputDirectory(outputInput, params.options.cwd);
-    ensurePathIsNotSymbolicLink(outputDir, 'Output directory');
-    ensurePathAncestorsContainNoSymbolicLinks(outputDir, 'Output directory', params.options.cwd);
-    mkdirSync(outputDir, { recursive: true });
-    const templateRelativePaths = collectDirectoryFiles(templateDir);
-    const templateOutputPaths = templateRelativePaths.map(relativePath => resolve(outputDir, relativePath));
-    await confirmOverwriteForExistingPaths({
-        options: params.options,
-        existingPaths: templateOutputPaths.filter(path => existsSync(path)),
-        promptMessage: 'Output files exist. Overwrite?',
-        cancelMessage: 'Output files exist and overwrite was cancelled',
-    });
-    copyDirectoryTree(templateDir, outputDir);
-    const sections = buildSkillSections({
-        definition: params.definition,
-        definitionDir: dirname(params.definitionPath),
-        facetsRoots: params.facetsRoots,
-    });
-    applyFacetTokensToFiles({
-        filePaths: templateOutputPaths.filter(path => existsSync(path)),
-        tokenValues: buildInlineFacetTokenValues(sections),
-        rootDir: outputDir,
-    });
-    return {
-        kind: 'path',
-        path: outputDir,
-    };
-}
-async function runStandardCompose(params) {
-    const safeName = ensureSafeDefinitionName(params.definition.name);
-    const facetSet = buildFacetSet({
-        definitionDir: dirname(params.definitionPath),
-        facetsRoots: params.facetsRoots,
-        definition: params.definition,
-    });
-    const composed = compose(facetSet, {
-        contextMaxChars: 2000,
-        userMessageOrder: params.definition.order,
-    });
-    const splitSelection = await params.options.select(['Combined (single file)', 'Split (system + user)'], 'Choose output mode with Up/Down and Enter:');
-    const outputPlans = buildComposeOutputPlans({
-        safeName,
-        systemPrompt: composed.systemPrompt,
-        userMessage: composed.userMessage,
-        splitSystem: splitSelection === 'Split (system + user)',
-    });
-    const outputInput = await params.options.input('Output directory', params.options.cwd);
-    const outputDir = resolveOutputDirectory(outputInput, params.options.cwd);
-    const existingPaths = outputPlans
-        .map(plan => resolve(outputDir, plan.fileName))
-        .filter(path => existsSync(path));
-    const overwrite = await confirmOverwriteForExistingPaths({
-        options: params.options,
-        existingPaths,
-        promptMessage: 'Output file exists. Overwrite?',
-        cancelMessage: 'Output file exists and overwrite was cancelled',
-    });
-    const outputPaths = [];
-    for (const plan of outputPlans) {
-        outputPaths.push(await writeComposeOutput({
-            outputDir,
-            fileName: plan.fileName,
-            content: plan.content,
-            overwrite,
-        }));
-    }
-    if (outputPaths.length === 1) {
-        return {
-            kind: 'path',
-            path: outputPaths[0],
-        };
-    }
-    return {
-        kind: 'paths',
-        paths: outputPaths,
-    };
-}
-export async function runComposeCommand(options) {
-    const { facetedRoots, facetsRoots, compositionsDirs } = getSkillPaths(options.cwd, options.homeDir);
-    const localCompositionsDir = facetedRoots.length > 1 ? resolve(facetedRoots[0], 'compositions') : undefined;
-    const globalCompositionsDir = resolve(facetedRoots[facetedRoots.length - 1], 'compositions');
-    const { definitionPath } = await selectCompositionDefinitionPath({
+import { resolveComposeDefinition } from './compose-definition-resolution.js';
+import { runStandardCompose, runTemplateBackedCompose } from './compose-execution.js';
+export async function runComposeCommand(options, composeOptions) {
+    const resolved = await resolveComposeDefinition({
         options,
-        compositionDefinitionDirs: compositionsDirs,
-        localCompositionsDir,
-        globalCompositionsDir,
-        cancelAction: 'Compose',
+        composeOptions,
     });
-    const definition = await loadComposeDefinition(definitionPath);
-    if (definition.template) {
+    if (resolved.definition.template) {
         return runTemplateBackedCompose({
             options,
-            facetedRoots,
-            facetsRoots,
-            definitionPath,
-            definition,
+            facetedRoots: resolved.facetedRoots,
+            facetsRoots: resolved.facetsRoots,
+            definitionPath: resolved.definitionPath,
+            definition: resolved.definition,
+            composeOptions,
         });
     }
     return runStandardCompose({
         options,
-        facetsRoots,
-        definitionPath,
-        definition,
+        facetsRoots: resolved.facetsRoots,
+        definitionPath: resolved.definitionPath,
+        definition: resolved.definition,
+        composeOptions,
     });
 }
 //# sourceMappingURL=compose-command.js.map

package/dist/cli/compose-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose-command.js","sourceRoot":"","sources":["../../src/cli/compose-command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compose-command.js","sourceRoot":"","sources":["../../src/cli/compose-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAGtF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAwB,EACxB,cAAiC;IAEjC,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAAC;QAC9C,OAAO;QACP,cAAc;KACf,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QACjC,OAAO,wBAAwB,CAAC;YAC9B,OAAO;YACP,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,cAAc,EAAE,QAAQ,CAAC,cAAc;YACvC,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,OAAO,kBAAkB,CAAC;QACxB,OAAO;QACP,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,cAAc;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/compose-definition-resolution.d.ts

@@ -0,0 +1,12 @@
+import type { ComposeDefinition } from '../types.js';
+import type { ComposeCliOptions, FacetCliOptions } from './types.js';
+export declare function resolveComposeDefinition(params: {
+    options: FacetCliOptions;
+    composeOptions: ComposeCliOptions;
+}): Promise<{
+    facetedRoots: readonly string[];
+    facetsRoots: readonly string[];
+    definitionPath: string;
+    definition: ComposeDefinition;
+}>;
+//# sourceMappingURL=compose-definition-resolution.d.ts.map

package/dist/cli/compose-definition-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-definition-resolution.d.ts","sourceRoot":"","sources":["../../src/cli/compose-definition-resolution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA0BrE,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,EAAE,iBAAiB,CAAC;CACnC,GAAG,OAAO,CAAC;IACV,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,iBAAiB,CAAC;CAC/B,CAAC,CAqCD"}

package/dist/cli/compose-definition-resolution.js

@@ -0,0 +1,50 @@
+import { loadComposeDefinition } from '../compose-definition.js';
+import { isNonInteractiveMode } from './compose-options.js';
+import { getSkillPaths, resolveCompositionDefinitionPathByName, selectCompositionDefinitionPath } from './skill-commands.js';
+function requireCompositionName(composeOptions) {
+    if (!composeOptions.composition) {
+        throw new Error('Non-interactive compose requires --composition');
+    }
+    return composeOptions.composition;
+}
+function validateNonInteractiveComposeOptions(params) {
+    if (params.definition.template) {
+        if (params.composeOptions.outputMode) {
+            throw new Error('Template-backed compose does not support --split or --combined');
+        }
+        return;
+    }
+    if (!params.composeOptions.outputMode) {
+        throw new Error('Non-interactive standard compose requires --split or --combined');
+    }
+}
+export async function resolveComposeDefinition(params) {
+    const { facetedRoots, facetsRoots, compositionsDirs, localCompositionsDir, globalCompositionsDir, } = getSkillPaths(params.options.cwd, params.options.homeDir);
+    const nonInteractive = isNonInteractiveMode(params.composeOptions);
+    const definitionPath = nonInteractive
+        ? resolveCompositionDefinitionPathByName({
+            compositionName: requireCompositionName(params.composeOptions),
+            compositionDefinitionDirs: compositionsDirs,
+        }).definitionPath
+        : (await selectCompositionDefinitionPath({
+            options: params.options,
+            compositionDefinitionDirs: compositionsDirs,
+            localCompositionsDir,
+            globalCompositionsDir,
+            cancelAction: 'Compose',
+        })).definitionPath;
+    const definition = await loadComposeDefinition(definitionPath);
+    if (nonInteractive) {
+        validateNonInteractiveComposeOptions({
+            composeOptions: params.composeOptions,
+            definition,
+        });
+    }
+    return {
+        facetedRoots,
+        facetsRoots,
+        definitionPath,
+        definition,
+    };
+}
+//# sourceMappingURL=compose-definition-resolution.js.map

package/dist/cli/compose-definition-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-definition-resolution.js","sourceRoot":"","sources":["../../src/cli/compose-definition-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,sCAAsC,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAG7H,SAAS,sBAAsB,CAAC,cAAiC;IAC/D,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,cAAc,CAAC,WAAW,CAAC;AACpC,CAAC;AAED,SAAS,oCAAoC,CAAC,MAG7C;IACC,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QAC/B,IAAI,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,MAG9C;IAMC,MAAM,EACJ,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GACtB,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,MAAM,cAAc,GAAG,oBAAoB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAEnE,MAAM,cAAc,GAAG,cAAc;QACnC,CAAC,CAAC,sCAAsC,CAAC;YACvC,eAAe,EAAE,sBAAsB,CAAC,MAAM,CAAC,cAAc,CAAC;YAC9D,yBAAyB,EAAE,gBAAgB;SAC5C,CAAC,CAAC,cAAc;QACjB,CAAC,CAAC,CAAC,MAAM,+BAA+B,CAAC;YACvC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,yBAAyB,EAAE,gBAAgB;YAC3C,oBAAoB;YACpB,qBAAqB;YACrB,YAAY,EAAE,SAAS;SACxB,CAAC,CAAC,CAAC,cAAc,CAAC;IAErB,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,cAAc,CAAC,CAAC;IAC/D,IAAI,cAAc,EAAE,CAAC;QACnB,oCAAoC,CAAC;YACnC,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,YAAY;QACZ,WAAW;QACX,cAAc;QACd,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/cli/compose-execution.d.ts

@@ -0,0 +1,18 @@
+import type { ComposeDefinition } from '../types.js';
+import type { ComposeCliOptions, FacetCliOptions, FacetCliResult } from './types.js';
+export declare function runTemplateBackedCompose(params: {
+    options: FacetCliOptions;
+    facetedRoots: readonly string[];
+    facetsRoots: readonly string[];
+    definitionPath: string;
+    definition: ComposeDefinition;
+    composeOptions: ComposeCliOptions;
+}): Promise<FacetCliResult>;
+export declare function runStandardCompose(params: {
+    options: FacetCliOptions;
+    facetsRoots: readonly string[];
+    definitionPath: string;
+    definition: ComposeDefinition;
+    composeOptions: ComposeCliOptions;
+}): Promise<FacetCliResult>;
+//# sourceMappingURL=compose-execution.d.ts.map

package/dist/cli/compose-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-execution.d.ts","sourceRoot":"","sources":["../../src/cli/compose-execution.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAuFrF,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,cAAc,EAAE,iBAAiB,CAAC;CACnC,GAAG,OAAO,CAAC,cAAc,CAAC,CAkD1B;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,cAAc,EAAE,iBAAiB,CAAC;CACnC,GAAG,OAAO,CAAC,cAAc,CAAC,CAsE1B"}

package/dist/cli/compose-execution.js

@@ -0,0 +1,165 @@
+import { existsSync, mkdirSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { compose } from '../compose.js';
+import { formatCombinedOutput, resolveOutputDirectory, writeComposeOutput } from '../output/index.js';
+import { isNonInteractiveMode } from './compose-options.js';
+import { buildFacetSet, buildSkillSections, ensureSafeDefinitionName, } from './skill-renderer.js';
+import { collectDirectoryFiles, copyDirectoryTree, ensureTemplateDirectoryFromRoots, shouldOverwrite, } from './install-skill/flow.js';
+import { applyFacetTokensToFiles, buildInlineFacetTokenValues } from './install-skill/facets.js';
+import { ensurePathAncestorsContainNoSymbolicLinks, ensurePathIsNotSymbolicLink } from './path-guard.js';
+function buildComposeOutputPlans(params) {
+    if (params.splitSystem) {
+        return [
+            {
+                fileName: `${params.safeName}.system.md`,
+                content: `${params.systemPrompt}\n`,
+            },
+            {
+                fileName: `${params.safeName}.user.md`,
+                content: `${params.userMessage}\n`,
+            },
+        ];
+    }
+    return [
+        {
+            fileName: `${params.safeName}.md`,
+            content: formatCombinedOutput({
+                systemPrompt: params.systemPrompt,
+                userMessage: params.userMessage,
+            }),
+        },
+    ];
+}
+async function confirmOverwriteForExistingPaths(params) {
+    if (params.existingPaths.length === 0) {
+        return false;
+    }
+    const overwriteAnswer = await params.options.input(`${params.promptMessage} (${params.existingPaths.join(', ')}) [y/N]`, 'n');
+    if (!shouldOverwrite(overwriteAnswer)) {
+        throw new Error(`${params.cancelMessage}: ${params.existingPaths.join(', ')}`);
+    }
+    return true;
+}
+function resolveOutputDir(params) {
+    const outputDir = resolveOutputDirectory(params.output, params.cwd);
+    ensurePathIsNotSymbolicLink(outputDir, 'Output directory');
+    ensurePathAncestorsContainNoSymbolicLinks(outputDir, 'Output directory', params.cwd);
+    mkdirSync(outputDir, { recursive: true });
+    return outputDir;
+}
+async function resolveComposeOutputDir(params) {
+    const outputInput = params.composeOptions.output ?? (isNonInteractiveMode(params.composeOptions)
+        ? params.options.cwd
+        : await params.options.input('Output directory', params.options.cwd));
+    return resolveOutputDir({
+        output: outputInput,
+        cwd: params.options.cwd,
+    });
+}
+export async function runTemplateBackedCompose(params) {
+    const templateName = params.definition.template;
+    if (!templateName) {
+        throw new Error(`Template-backed compose requires template: ${params.definition.name}`);
+    }
+    const templateDir = ensureTemplateDirectoryFromRoots(params.facetedRoots, templateName, dirname(params.definitionPath));
+    const nonInteractive = isNonInteractiveMode(params.composeOptions);
+    const outputDir = await resolveComposeOutputDir({
+        options: params.options,
+        composeOptions: params.composeOptions,
+    });
+    const templateRelativePaths = collectDirectoryFiles(templateDir);
+    const templateOutputPaths = templateRelativePaths.map(relativePath => resolve(outputDir, relativePath));
+    const existingPaths = templateOutputPaths.filter(path => existsSync(path));
+    if (params.composeOptions.overwrite !== true) {
+        if (nonInteractive) {
+            if (existingPaths.length > 0) {
+                throw new Error(`Output files exist and overwrite was cancelled: ${existingPaths.join(', ')}`);
+            }
+        }
+        else {
+            await confirmOverwriteForExistingPaths({
+                options: params.options,
+                existingPaths,
+                promptMessage: 'Output files exist. Overwrite?',
+                cancelMessage: 'Output files exist and overwrite was cancelled',
+            });
+        }
+    }
+    copyDirectoryTree(templateDir, outputDir);
+    const sections = buildSkillSections({
+        definition: params.definition,
+        definitionDir: dirname(params.definitionPath),
+        facetsRoots: params.facetsRoots,
+    });
+    applyFacetTokensToFiles({
+        filePaths: templateOutputPaths.filter(path => existsSync(path)),
+        tokenValues: buildInlineFacetTokenValues(sections),
+        rootDir: outputDir,
+    });
+    return {
+        kind: 'path',
+        path: outputDir,
+    };
+}
+export async function runStandardCompose(params) {
+    const safeName = ensureSafeDefinitionName(params.definition.name);
+    const facetSet = buildFacetSet({
+        definitionDir: dirname(params.definitionPath),
+        facetsRoots: params.facetsRoots,
+        definition: params.definition,
+    });
+    const composed = compose(facetSet, {
+        contextMaxChars: 2000,
+        userMessageOrder: params.definition.order,
+    });
+    const nonInteractive = isNonInteractiveMode(params.composeOptions);
+    const splitSelection = params.composeOptions.outputMode
+        ? (params.composeOptions.outputMode === 'split' ? 'Split (system + user)' : 'Combined (single file)')
+        : await params.options.select(['Combined (single file)', 'Split (system + user)'], 'Choose output mode with Up/Down and Enter:');
+    const outputPlans = buildComposeOutputPlans({
+        safeName,
+        systemPrompt: composed.systemPrompt,
+        userMessage: composed.userMessage,
+        splitSystem: splitSelection === 'Split (system + user)',
+    });
+    const outputDir = await resolveComposeOutputDir({
+        options: params.options,
+        composeOptions: params.composeOptions,
+    });
+    const existingPaths = outputPlans
+        .map(plan => resolve(outputDir, plan.fileName))
+        .filter(path => existsSync(path));
+    const overwrite = params.composeOptions.overwrite === true
+        ? true
+        : nonInteractive
+            ? false
+            : await confirmOverwriteForExistingPaths({
+                options: params.options,
+                existingPaths,
+                promptMessage: 'Output file exists. Overwrite?',
+                cancelMessage: 'Output file exists and overwrite was cancelled',
+            });
+    if (!overwrite && existingPaths.length > 0) {
+        throw new Error(`Output file exists and overwrite was cancelled: ${existingPaths.join(', ')}`);
+    }
+    const outputPaths = [];
+    for (const plan of outputPlans) {
+        outputPaths.push(await writeComposeOutput({
+            outputDir,
+            fileName: plan.fileName,
+            content: plan.content,
+            overwrite,
+        }));
+    }
+    if (outputPaths.length === 1) {
+        return {
+            kind: 'path',
+            path: outputPaths[0],
+        };
+    }
+    return {
+        kind: 'paths',
+        paths: outputPaths,
+    };
+}
+//# sourceMappingURL=compose-execution.js.map

package/dist/cli/compose-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-execution.js","sourceRoot":"","sources":["../../src/cli/compose-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEtG,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,gCAAgC,EAChC,eAAe,GAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACjG,OAAO,EAAE,yCAAyC,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAEzG,SAAS,uBAAuB,CAAC,MAKhC;IACC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO;YACL;gBACE,QAAQ,EAAE,GAAG,MAAM,CAAC,QAAQ,YAAY;gBACxC,OAAO,EAAE,GAAG,MAAM,CAAC,YAAY,IAAI;aACpC;YACD;gBACE,QAAQ,EAAE,GAAG,MAAM,CAAC,QAAQ,UAAU;gBACtC,OAAO,EAAE,GAAG,MAAM,CAAC,WAAW,IAAI;aACnC;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL;YACE,QAAQ,EAAE,GAAG,MAAM,CAAC,QAAQ,KAAK;YACjC,OAAO,EAAE,oBAAoB,CAAC;gBAC5B,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC,CAAC;SACH;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,gCAAgC,CAAC,MAK/C;IACC,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAChD,GAAG,MAAM,CAAC,aAAa,KAAK,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EACpE,GAAG,CACJ,CAAC;IACF,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,aAAa,KAAK,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,MAGzB;IACC,MAAM,SAAS,GAAG,sBAAsB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACpE,2BAA2B,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IAC3D,yCAAyC,CAAC,SAAS,EAAE,kBAAkB,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACrF,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,MAGtC;IACC,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,IAAI,CAClD,oBAAoB,CAAC,MAAM,CAAC,cAAc,CAAC;QACzC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG;QACpB,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CACvE,CAAC;IAEF,OAAO,gBAAgB,CAAC;QACtB,MAAM,EAAE,WAAW;QACnB,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG;KACxB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,MAO9C;IACC,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC;IAChD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,8CAA8C,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,MAAM,WAAW,GAAG,gCAAgC,CAAC,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;IACxH,MAAM,cAAc,GAAG,oBAAoB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC;QAC9C,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,CAAC,CAAC;IAEH,MAAM,qBAAqB,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IACjE,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;IACxG,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAE3E,IAAI,MAAM,CAAC,cAAc,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC7C,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,mDAAmD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjG,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,gCAAgC,CAAC;gBACrC,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,aAAa;gBACb,aAAa,EAAE,gCAAgC;gBAC/C,aAAa,EAAE,gDAAgD;aAChE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAE1C,MAAM,QAAQ,GAAG,kBAAkB,CAAC;QAClC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;QAC7C,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC;IAEH,uBAAuB,CAAC;QACtB,SAAS,EAAE,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/D,WAAW,EAAE,2BAA2B,CAAC,QAAQ,CAAC;QAClD,OAAO,EAAE,SAAS;KACnB,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,SAAS;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAMxC;IACC,MAAM,QAAQ,GAAG,wBAAwB,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,aAAa,CAAC;QAC7B,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;QAC7C,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE;QACjC,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK;KAC1C,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,oBAAoB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACnE,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC,UAAU;QACrD,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,wBAAwB,CAAC;QACrG,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAC3B,CAAC,wBAAwB,EAAE,uBAAuB,CAAC,EACnD,4CAA4C,CAC7C,CAAC;IACJ,MAAM,WAAW,GAAG,uBAAuB,CAAC;QAC1C,QAAQ;QACR,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,WAAW,EAAE,cAAc,KAAK,uBAAuB;KACxD,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC;QAC9C,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,WAAW;SAC9B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;SAC9C,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,SAAS,KAAK,IAAI;QACxD,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,cAAc;YACd,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,MAAM,gCAAgC,CAAC;gBACvC,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,aAAa;gBACb,aAAa,EAAE,gCAAgC;gBAC/C,aAAa,EAAE,gDAAgD;aAChE,CAAC,CAAC;IAEP,IAAI,CAAC,SAAS,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,mDAAmD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC;IAED,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,WAAW,CAAC,IAAI,CAAC,MAAM,kBAAkB,CAAC;YACxC,SAAS;YACT,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS;SACV,CAAC,CAAC,CAAC;IACN,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,WAAW,CAAC,CAAC,CAAE;SACtB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,WAAW;KACnB,CAAC;AACJ,CAAC"}

package/dist/cli/compose-options.d.ts

@@ -0,0 +1,4 @@
+import type { ComposeCliOptions } from './types.js';
+export declare function parseComposeOptions(args: readonly string[]): ComposeCliOptions;
+export declare function isNonInteractiveMode(options: ComposeCliOptions): boolean;
+//# sourceMappingURL=compose-options.d.ts.map

package/dist/cli/compose-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-options.d.ts","sourceRoot":"","sources":["../../src/cli/compose-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAcpD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CA0D9E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAKxE"}

package/dist/cli/compose-options.js

@@ -0,0 +1,64 @@
+function requireOptionValue(args, index, optionName) {
+    const value = args[index + 1];
+    if (!value || value.startsWith('--')) {
+        throw new Error(`Missing value for ${optionName}`);
+    }
+    return value;
+}
+export function parseComposeOptions(args) {
+    let composition;
+    let outputMode;
+    let output;
+    let overwrite = false;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === undefined) {
+            throw new Error('Unsupported compose argument: undefined');
+        }
+        if (arg === '--composition') {
+            composition = requireOptionValue(args, index, '--composition');
+            index += 1;
+            continue;
+        }
+        if (arg === '--output') {
+            output = requireOptionValue(args, index, '--output');
+            index += 1;
+            continue;
+        }
+        if (arg === '--split') {
+            if (outputMode === 'combined') {
+                throw new Error('Cannot specify both --split and --combined');
+            }
+            outputMode = 'split';
+            continue;
+        }
+        if (arg === '--combined') {
+            if (outputMode === 'split') {
+                throw new Error('Cannot specify both --split and --combined');
+            }
+            outputMode = 'combined';
+            continue;
+        }
+        if (arg === '--overwrite') {
+            overwrite = true;
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            throw new Error(`Unsupported compose option: ${arg}`);
+        }
+        throw new Error(`Unsupported compose argument: ${arg}`);
+    }
+    return {
+        composition,
+        outputMode,
+        output,
+        overwrite: overwrite || undefined,
+    };
+}
+export function isNonInteractiveMode(options) {
+    return options.composition !== undefined
+        || options.outputMode !== undefined
+        || options.output !== undefined
+        || options.overwrite === true;
+}
+//# sourceMappingURL=compose-options.js.map

package/dist/cli/compose-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-options.js","sourceRoot":"","sources":["../../src/cli/compose-options.ts"],"names":[],"mappings":"AAEA,SAAS,kBAAkB,CACzB,IAAuB,EACvB,KAAa,EACb,UAAwC;IAExC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,qBAAqB,UAAU,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,IAAI,WAA+B,CAAC;IACpC,IAAI,UAA2C,CAAC;IAChD,IAAI,MAA0B,CAAC;IAC/B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,GAAG,KAAK,eAAe,EAAE,CAAC;YAC5B,WAAW,GAAG,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;YAC/D,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YACvB,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;YACrD,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAChE,CAAC;YACD,UAAU,GAAG,OAAO,CAAC;YACrB,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YACzB,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAChE,CAAC;YACD,UAAU,GAAG,UAAU,CAAC;YACxB,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;YAC1B,SAAS,GAAG,IAAI,CAAC;YACjB,SAAS;QACX,CAAC;QAED,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO;QACL,WAAW;QACX,UAAU;QACV,MAAM;QACN,SAAS,EAAE,SAAS,IAAI,SAAS;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAA0B;IAC7D,OAAO,OAAO,CAAC,WAAW,KAAK,SAAS;WACnC,OAAO,CAAC,UAAU,KAAK,SAAS;WAChC,OAAO,CAAC,MAAM,KAAK,SAAS;WAC5B,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC;AAClC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA2BlE,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CA4DzB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA2BlE,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CA4DzB"}

package/dist/cli/index.js

@@ -2,6 +2,7 @@ import { existsSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { initializeGlobalFaceted, initializeLocalFaceted, listPullSampleTargetPaths, pullSampleFacets, } from '../init/index.js';
 import { runComposeCommand, } from './compose-command.js';
+import { parseComposeOptions } from './compose-options.js';
 import { runInstallSkillCommand, } from './skill-commands.js';
 import { shouldOverwrite } from './install-skill/flow.js';
 const USAGE = [
@@ -65,7 +66,7 @@ export async function runFacetCli(args, options) {
         throw new Error(`Unsupported command: ${command}`);
     }
     if (command === 'compose') {
-        return runComposeCommand(options);
+        return runComposeCommand(options, parseComposeOptions(args.slice(1)));
     }
     if (command === 'install') {
         ensureSkillSubcommand(command, subcommand);