faceted-prompting 0.0.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Masanobu Naruse
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,211 @@
 # faceted-prompting
 
-Faceted Prompting - A design pattern for composing structured AI prompts from multiple facets.
+[Faceted Prompting 解説記事](https://nrslib.com/faceted-prompting)
 
-Work in progress.
+Structured prompt composition for LLMs — decompose prompts into reusable facets and compose them into LLM-ready messages.
+
+faceted-prompting separates prompt concerns into distinct facets (persona, policy, knowledge, instruction), each with a defined role and message placement. This keeps prompts modular, testable, and maintainable as they grow in complexity.
+
+## Why Faceted Prompting
+
+**Separation of concerns** — Each facet has a single responsibility. Persona defines *who* the agent is, policies define *how* it should behave, knowledge provides *what it needs to know*, and instructions define *what to do*. Changes to one facet don't affect others.
+
+**Deterministic placement** — Persona always goes to the system prompt. Policies, knowledge, and instructions always go to the user message. This placement rule is enforced by the library, not left to convention.
+
+**Composable** — Facets are plain Markdown files. Mix and match personas, policies, and knowledge across different workflows. Share them as repertoire packages via `@owner/repo/facet-name` scope references.
+
+**Framework-independent** — Zero dependencies on any specific AI framework. Use it with Claude, OpenAI, or any LLM provider.
+
+## Facet Kinds
+
+| Facet | Placement | Role |
+|-------|-----------|------|
+| **Persona** | System prompt | WHO — agent identity and character |
+| **Policy** | User message | HOW — rules, standards, constraints |
+| **Knowledge** | User message | WHAT TO KNOW — domain context, architecture |
+| **Instruction** | User message | WHAT TO DO — the specific task |
+
+## Install
+
+```bash
+npm install faceted-prompting
+```
+
+Global CLI:
+
+```bash
+npm install -g faceted-prompting
+facet init
+facet pull-sample
+```
+
+## Quick Start
+
+### As a library
+
+```typescript
+import { compose } from 'faceted-prompting';
+
+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.' },
+  },
+  { contextMaxChars: 8000 },
+);
+
+// result.systemPrompt → "You are a senior TypeScript developer."
+// result.userMessage  → policies + knowledge + instruction (in order)
+```
+
+### As a CLI
+
+```bash
+# Create local defaults under ~/.faceted
+facet init
+
+# Pull sample facets from TAKT on GitHub
+facet pull-sample
+
+# Compose prompts with auto-detected context
+facet compose
+
+# Install a skill to Claude Code or Codex
+facet install skill
+```
+
+`facet init` creates `~/.faceted/` with config, directories, compositions, and templates:
+
+```
+~/.faceted/
+├── config.yaml
+├── facets/
+│   ├── persona/          # Persona Markdown files
+│   ├── knowledge/        # Domain knowledge files
+│   ├── policies/         # Policy/rules files
+│   └── compositions/     # Compose definition YAML files
+└── templates/            # Skill templates
+```
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `facet init` | Create local config, facet directories, compositions, and templates |
+| `facet pull-sample` | Pull sample coding facets from TAKT on GitHub |
+| `facet compose` | Auto-detect context, compose prompts, and write to files |
+| `facet install skill` | Install a skill with facets to Claude Code or Codex |
+
+See the [CLI Reference](./docs/cli-reference.md) for details.
+
+## Compose Definition
+
+Place definition files in `~/.faceted/compositions/*.yaml`:
+
+```yaml
+name: release
+description: Release summary composition
+persona: coder
+knowledge:
+  - architecture
+policies:
+  - quality
+instruction: Summarize release impact.
+order:
+  - knowledge
+  - 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.
+
+## Scope References
+
+Reference facets from installed repertoire packages using `@owner/repo/facet-name` syntax:
+
+```yaml
+persona: "@nrslib/takt-fullstack/expert-coder"
+knowledge:
+  - "@nrslib/takt-fullstack/architecture"
+```
+
+Scope references resolve to `~/.faceted/repertoire/@{owner}/{repo}/facets/{kind}/{name}.md`.
+
+## API
+
+### `compose(facets, options)`
+
+Core composition function. Takes a `FacetSet` and `ComposeOptions`, returns a `ComposedPrompt` with `systemPrompt` and `userMessage`.
+
+### `composePromptPayload(params)`
+
+Higher-level API that composes prompts from a `ComposeDefinition` and also returns `copyFiles` metadata listing the source file paths used.
+
+### `FileDataEngine`
+
+File-system backed facet loader. Reads `{root}/{kind}/{key}.md`.
+
+```typescript
+import { FileDataEngine } from 'faceted-prompting';
+
+const engine = new FileDataEngine('./prompts');
+const persona = await engine.resolve('personas', 'coder');
+```
+
+### `CompositeDataEngine`
+
+Chains multiple `DataEngine` instances with first-match-wins resolution. Useful for layering project-level facets over global defaults.
+
+```typescript
+import { FileDataEngine, CompositeDataEngine } from 'faceted-prompting';
+
+const engine = new CompositeDataEngine([
+  new FileDataEngine('./project/facets'),   // project-level (wins)
+  new FileDataEngine('~/.faceted/facets'),   // global fallback
+]);
+```
+
+### `renderTemplate(template, vars)`
+
+Minimal template engine with `{{variable}}` substitution and `{{#if var}}...{{else}}...{{/if}}` conditionals.
+
+### `escapeTemplateChars(str)`
+
+Escapes curly braces to full-width Unicode equivalents to prevent template injection in user-supplied content.
+
+See the [API Reference](./docs/api-reference.md) for the full API surface.
+
+## Project Structure
+
+```
+~/.faceted/                     # Global config (created on first run)
+├── config.yaml
+├── facets/
+│   ├── persona/
+│   ├── knowledge/
+│   ├── policies/
+│   └── compositions/
+├── templates/                  # Skill install templates
+└── repertoire/                 # Installed repertoire packages
+```
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [Concepts](./docs/concepts.md) | Faceted Prompting design methodology |
+| [CLI Reference](./docs/cli-reference.md) | All commands and options |
+| [API Reference](./docs/api-reference.md) | Library API surface |
+| [Changelog](./CHANGELOG.md) | Version history |
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for details.
+
+## License
+
+MIT — See [LICENSE](./LICENSE) for details.

package/bin/facet

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/cli/runner.js').then(m => m.main(process.argv.slice(2)));

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

@@ -0,0 +1,8 @@
+export interface ComposeContext {
+    readonly name: 'coding' | 'frontend' | 'backend';
+    readonly knowledgeRefs: readonly string[];
+    readonly relatedFiles: readonly string[];
+    readonly relatedInstruction?: string;
+}
+export declare function resolveComposeContext(cwd: string): ComposeContext;
+//# sourceMappingURL=compose-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compose-context.d.ts","sourceRoot":"","sources":["../../src/cli/compose-context.ts"],"names":[],"mappings":"AAuDA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AA2JD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAWjE"}

package/dist/cli/compose-context.js

@@ -0,0 +1,194 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { extname, relative, resolve, sep } from 'node:path';
+import { renderConflictNotice, trimContextContent } from '../truncation.js';
+const CONTEXT_MAX_CHARS = 2000;
+const MAX_FALLBACK_FILES = 12;
+const FRONTEND_EXTENSIONS = new Set([
+    '.tsx',
+    '.jsx',
+    '.css',
+    '.scss',
+    '.sass',
+    '.less',
+    '.html',
+    '.vue',
+    '.svelte',
+]);
+const SOURCE_EXTENSIONS = new Set([
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.cjs',
+    '.json',
+    '.css',
+    '.scss',
+    '.sass',
+    '.less',
+    '.html',
+    '.vue',
+    '.svelte',
+    '.java',
+    '.kt',
+    '.kts',
+    '.go',
+    '.py',
+    '.rb',
+    '.rs',
+    '.php',
+    '.cs',
+    '.swift',
+    '.sql',
+    '.yml',
+    '.yaml',
+    '.md',
+]);
+const FRONTEND_PATH_PARTS = ['frontend', 'web', 'ui', 'client', 'components', 'pages', 'styles'];
+const BACKEND_PATH_PARTS = ['backend', 'server', 'api', 'db', 'database', 'prisma', 'migrations'];
+const IGNORED_DIRS = new Set(['.git', 'node_modules', 'dist', 'build', 'coverage', '.next']);
+function normalizeRelativePath(cwd, filePath) {
+    const resolvedPath = resolve(cwd, filePath);
+    const relativePath = relative(cwd, resolvedPath);
+    if (relativePath.startsWith(`..${sep}`) || relativePath === '..') {
+        throw new Error(`Related file escapes working directory: ${filePath}`);
+    }
+    return relativePath.length > 0 ? relativePath : filePath;
+}
+function isSourceFile(filePath) {
+    return SOURCE_EXTENSIONS.has(extname(filePath).toLowerCase());
+}
+function collectFallbackFiles(cwd, currentDir = cwd, acc = []) {
+    const entries = readdirSync(currentDir, { withFileTypes: true })
+        .sort((a, b) => a.name.localeCompare(b.name));
+    for (const entry of entries) {
+        if (acc.length >= MAX_FALLBACK_FILES) {
+            return acc;
+        }
+        if (entry.isDirectory()) {
+            if (!IGNORED_DIRS.has(entry.name)) {
+                collectFallbackFiles(cwd, resolve(currentDir, entry.name), acc);
+            }
+            continue;
+        }
+        const fullPath = resolve(currentDir, entry.name);
+        const relativePath = relative(cwd, fullPath);
+        if (isSourceFile(relativePath)) {
+            acc.push(relativePath);
+        }
+    }
+    return acc;
+}
+function detectGitRelatedFiles(cwd) {
+    try {
+        execFileSync('git', ['rev-parse', '--show-toplevel'], {
+            cwd,
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        }).trim();
+    }
+    catch {
+        return [];
+    }
+    const collected = new Set();
+    const commands = [
+        ['diff', '--name-only', '--diff-filter=ACMR'],
+        ['diff', '--name-only', '--cached', '--diff-filter=ACMR'],
+        ['ls-files', '--others', '--exclude-standard'],
+    ];
+    for (const args of commands) {
+        const output = execFileSync('git', args, {
+            cwd,
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        });
+        for (const line of output.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            if (isSourceFile(trimmed)) {
+                collected.add(trimmed);
+            }
+        }
+    }
+    return Array.from(collected).sort();
+}
+function isFrontendFile(filePath) {
+    const normalized = filePath.toLowerCase();
+    if (FRONTEND_EXTENSIONS.has(extname(normalized))) {
+        return true;
+    }
+    return FRONTEND_PATH_PARTS.some(part => normalized.includes(`/${part}/`) || normalized.startsWith(`${part}/`));
+}
+function isBackendFile(filePath) {
+    const normalized = filePath.toLowerCase();
+    return BACKEND_PATH_PARTS.some(part => normalized.includes(`/${part}/`) || normalized.startsWith(`${part}/`));
+}
+function inferPromptName(relatedFiles) {
+    const hasFrontend = relatedFiles.some(isFrontendFile);
+    const hasBackend = relatedFiles.some(isBackendFile);
+    if (hasFrontend && !hasBackend) {
+        return 'frontend';
+    }
+    if (hasBackend && !hasFrontend) {
+        return 'backend';
+    }
+    return 'coding';
+}
+function inferKnowledgeRefs(relatedFiles) {
+    const refs = ['architecture'];
+    if (relatedFiles.some(isFrontendFile)) {
+        refs.push('frontend');
+    }
+    if (relatedFiles.some(isBackendFile)) {
+        refs.push('backend');
+    }
+    return refs;
+}
+function renderRelatedFileBlock(cwd, relativePath) {
+    const absolutePath = resolve(cwd, relativePath);
+    if (!existsSync(absolutePath)) {
+        return undefined;
+    }
+    const stats = statSync(absolutePath);
+    if (!stats.isFile()) {
+        return undefined;
+    }
+    const content = readFileSync(absolutePath, 'utf-8');
+    const prepared = trimContextContent(content, CONTEXT_MAX_CHARS);
+    const lines = [
+        `## ${relativePath}`,
+        '',
+        prepared.content,
+        '',
+        `Source: ${relativePath}`,
+        '',
+        renderConflictNotice(),
+    ];
+    return lines.join('\n');
+}
+function buildRelatedInstruction(cwd, relatedFiles) {
+    if (relatedFiles.length === 0) {
+        return undefined;
+    }
+    const blocks = relatedFiles
+        .map(filePath => renderRelatedFileBlock(cwd, filePath))
+        .filter((block) => block !== undefined);
+    if (blocks.length === 0) {
+        return undefined;
+    }
+    return ['# Related Files', '', ...blocks].join('\n\n');
+}
+export function resolveComposeContext(cwd) {
+    const relatedFiles = detectGitRelatedFiles(cwd);
+    const normalizedFiles = (relatedFiles.length > 0 ? relatedFiles : collectFallbackFiles(cwd))
+        .map(filePath => normalizeRelativePath(cwd, filePath));
+    return {
+        name: inferPromptName(normalizedFiles),
+        knowledgeRefs: inferKnowledgeRefs(normalizedFiles),
+        relatedFiles: normalizedFiles,
+        relatedInstruction: buildRelatedInstruction(cwd, normalizedFiles),
+    };
+}
+//# sourceMappingURL=compose-context.js.map

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

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

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+import type { FacetCliOptions, FacetCliResult } from './types.js';
+export declare function runFacetCli(args: string[], options: FacetCliOptions): Promise<FacetCliResult>;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/cli/index.js

@@ -0,0 +1,144 @@
+import { existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { compose } from '../compose.js';
+import { readFacetedConfig } from '../config/index.js';
+import { initializeFacetedHome, listPullSampleTargetPaths, pullSampleFacets } from '../init/index.js';
+import { formatCombinedOutput, resolveOutputDirectory, writeComposeOutput } from '../output/index.js';
+import { resolveComposeContext } from './compose-context.js';
+import { buildFacetSet, ensureSafeDefinitionName } from './skill-renderer.js';
+import { getSkillPaths, runInstallSkillCommand, } from './skill-commands.js';
+import { shouldOverwrite } from './install-skill/flow.js';
+const USAGE = [
+    'Usage: facet <command>',
+    '',
+    'Commands:',
+    '  init                 Initialize local faceted home',
+    '  pull-sample          Pull sample coding facets from TAKT on GitHub',
+    '  compose              Compose facets into a prompt file',
+    '  install skill        Install a skill from a composition',
+].join('\n');
+function ensureCommand(command) {
+    if (!command) {
+        throw new Error(USAGE);
+    }
+    return command;
+}
+function ensureSkillSubcommand(command, subcommand) {
+    if (subcommand !== 'skill') {
+        throw new Error(`Unsupported command: ${command}`);
+    }
+}
+async function runComposeCommand(options) {
+    const { facetsRoot, compositionsDir } = getSkillPaths(options.homeDir);
+    const composeContext = resolveComposeContext(options.cwd);
+    const definition = {
+        name: composeContext.name,
+        persona: 'coder',
+        policies: ['coding', 'ai-antipattern'],
+        knowledge: composeContext.knowledgeRefs,
+        instruction: composeContext.relatedInstruction,
+        order: ['policies', 'knowledge', 'instruction'],
+    };
+    const definitionDir = dirname(compositionsDir);
+    const facetSet = buildFacetSet({
+        definitionDir,
+        facetsRoot,
+        definition,
+    });
+    const composed = compose(facetSet, {
+        contextMaxChars: 2000,
+        userMessageOrder: definition.order,
+    });
+    const splitSelection = await options.select(['Combined (single file)', 'Split (system + user)'], 'Choose output mode with Up/Down and Enter:');
+    const splitSystem = splitSelection === 'Split (system + user)';
+    const outputInput = await options.input('Output directory', options.cwd);
+    const outputDir = resolveOutputDirectory(outputInput, options.cwd);
+    const safeName = ensureSafeDefinitionName(definition.name);
+    const outputPlans = splitSystem
+        ? [
+            {
+                fileName: `${safeName}.system.md`,
+                content: `${composed.systemPrompt}\n`,
+            },
+            {
+                fileName: `${safeName}.user.md`,
+                content: `${composed.userMessage}\n`,
+            },
+        ]
+        : [
+            {
+                fileName: `${safeName}.md`,
+                content: formatCombinedOutput(composed),
+            },
+        ];
+    const existingPaths = outputPlans
+        .map(plan => resolve(outputDir, plan.fileName))
+        .filter(path => existsSync(path));
+    let overwrite = false;
+    if (existingPaths.length > 0) {
+        const overwriteAnswer = await options.input(`Output file exists. Overwrite? (${existingPaths.join(', ')}) [y/N]`, 'n');
+        if (!shouldOverwrite(overwriteAnswer)) {
+            throw new Error(`Output file exists and overwrite was cancelled: ${existingPaths.join(', ')}`);
+        }
+        overwrite = true;
+    }
+    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 runFacetCli(args, options) {
+    const command = ensureCommand(args[0]);
+    const subcommand = args[1];
+    if (command === 'init') {
+        await initializeFacetedHome({ homeDir: options.homeDir });
+        return {
+            kind: 'text',
+            text: `Initialized: ${resolve(options.homeDir, '.faceted')}`,
+        };
+    }
+    if (command === 'pull-sample') {
+        const overlappingPaths = listPullSampleTargetPaths(options.homeDir).filter(path => existsSync(path));
+        let overwrite = false;
+        if (overlappingPaths.length > 0) {
+            const overwriteAnswer = await options.input(`Pull sample will overwrite existing files. Continue? (${overlappingPaths.join(', ')}) [y/N]`, 'n');
+            if (!shouldOverwrite(overwriteAnswer)) {
+                throw new Error(`Pull sample was cancelled: ${overlappingPaths.join(', ')}`);
+            }
+            overwrite = true;
+        }
+        await pullSampleFacets({ homeDir: options.homeDir, overwrite });
+        return {
+            kind: 'text',
+            text: `Pulled sample: ${resolve(options.homeDir, '.faceted')}`,
+        };
+    }
+    if (command !== 'compose' && command !== 'install') {
+        throw new Error(`Unsupported command: ${command}`);
+    }
+    await readFacetedConfig(options.homeDir);
+    if (command === 'compose') {
+        return runComposeCommand(options);
+    }
+    if (command === 'install') {
+        ensureSkillSubcommand(command, subcommand);
+        return runInstallSkillCommand(options);
+    }
+    throw new Error(`Unsupported command: ${command}`);
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

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

@@ -0,0 +1,28 @@
+import type { buildSkillSections } from '../skill-renderer.js';
+import type { CopyFiles } from '../../types.js';
+type FacetPlaceholderKey = 'persona' | 'knowledges' | 'policies' | 'instructions';
+type FacetTokenValues = Record<FacetPlaceholderKey, string>;
+export type SkillSections = ReturnType<typeof buildSkillSections>;
+export interface FacetPathMap {
+    readonly persona: string;
+    readonly knowledges: readonly string[];
+    readonly policies: readonly string[];
+    readonly instructions?: string;
+}
+export declare function buildInlineFacetTokenValues(sections: SkillSections): FacetTokenValues;
+export declare function buildSectionsWithCopiedPaths(sections: SkillSections, facets: FacetPathMap): SkillSections;
+export declare function copyFacetFiles(params: {
+    targetDir: string;
+    safeSkillName: string;
+    copyFiles: CopyFiles;
+    literalInstructionBody?: string;
+}): FacetPathMap;
+export declare function applyFacetTokensToPath(params: {
+    rootDir: string;
+    maxDepth: number;
+    tokenValues: FacetTokenValues;
+    excludeDirs: readonly string[];
+}): void;
+export declare function parseScanDepth(rawDepth: string): number;
+export {};
+//# sourceMappingURL=facets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"facets.d.ts","sourceRoot":"","sources":["../../../src/cli/install-skill/facets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKhD,KAAK,mBAAmB,GAAG,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,cAAc,CAAC;AAClF,KAAK,gBAAgB,GAAG,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAElE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AA8BD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,aAAa,GAAG,gBAAgB,CAOrF;AAQD,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,YAAY,GACnB,aAAa,CA6Cf;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,SAAS,CAAC;IACrB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,GAAG,YAAY,CAiDf;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,GAAG,IAAI,CAqCP;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMvD"}