faceted-prompting 0.0.0 → 0.2.0

package/dist/init/index.js

@@ -0,0 +1,197 @@
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { ensureConfigFile, getFacetedRoot } from '../config/index.js';
+const REQUIRED_FACET_DIRS = ['persona', 'knowledge', 'policies', 'output-contracts'];
+const TAKT_BOOTSTRAP_BASE_URL = 'https://raw.githubusercontent.com/nrslib/takt/main/builtins/ja/facets';
+function makeComposition(name, description, knowledge) {
+    const lines = [
+        `name: ${name}`,
+        `description: ${description}`,
+        'persona: coder',
+        'policies:',
+        '  - coding',
+        '  - ai-antipattern',
+        'knowledge:',
+        ...knowledge.map(k => `  - ${k}`),
+    ];
+    return lines.join('\n') + '\n';
+}
+const DEFAULT_COMPOSITIONS = [
+    {
+        relativePath: 'compositions/coding.yaml',
+        content: makeComposition('coding', 'General coding with architecture knowledge', ['architecture']),
+    },
+    {
+        relativePath: 'compositions/frontend.yaml',
+        content: makeComposition('frontend', 'Frontend coding with architecture + frontend knowledge', ['architecture', 'frontend']),
+    },
+    {
+        relativePath: 'compositions/backend.yaml',
+        content: makeComposition('backend', 'Backend coding with architecture + backend knowledge', ['architecture', 'backend']),
+    },
+    {
+        relativePath: 'compositions/issue-worktree.yaml',
+        content: [
+            'name: issue-worktree',
+            'description: Issue-oriented coding skill deployed from a multi-file template',
+            'persona: coder',
+            'policies:',
+            '  - coding',
+            '  - ai-antipattern',
+            'knowledge:',
+            '  - architecture',
+            'instruction: |',
+            '  Confirm the issue scope before editing, keep the change minimal, and report build/test results.',
+            'template: issue-worktree',
+            '',
+        ].join('\n'),
+    },
+];
+const DEFAULT_TEMPLATES = [
+    {
+        relativePath: 'templates/issue-worktree/SKILL.md',
+        content: [
+            '# Issue Worker',
+            '',
+            '## Persona',
+            '{{facet:persona}}',
+            '',
+            '## Policies',
+            '{{facet:policies}}',
+            '',
+            '## Knowledge',
+            '{{facet:knowledges}}',
+            '',
+            '## Instructions',
+            '{{facet:instructions}}',
+            '',
+            '## Workflow',
+            '- Confirm the issue scope before editing.',
+            '- Keep changes minimal and explicit.',
+            '- Run build/test and report the outcome.',
+            '',
+        ].join('\n'),
+    },
+    {
+        relativePath: 'templates/issue-worktree/README.md',
+        content: [
+            '# Issue Worker Template',
+            '',
+            'This sample template shows how a multi-file skill workspace can be structured for issue-oriented coding tasks.',
+            '',
+            'Included files:',
+            '- `SKILL.md`',
+            '- `templates/instructions/fix.md`',
+            '- `templates/instructions/review.md`',
+            '',
+            'Facet placeholders in `SKILL.md` are replaced during `facet install skill`.',
+            '',
+        ].join('\n'),
+    },
+    {
+        relativePath: 'templates/issue-worktree/templates/instructions/fix.md',
+        content: [
+            '# Fix Checklist',
+            '',
+            '- Reproduce the issue first.',
+            '- Verify the smallest safe fix.',
+            '- Record build/test evidence after the change.',
+            '',
+        ].join('\n'),
+    },
+    {
+        relativePath: 'templates/issue-worktree/templates/instructions/review.md',
+        content: [
+            '# Review Checklist',
+            '',
+            '- Check for scope creep.',
+            '- Check for missing tests or validation.',
+            '- Check for hidden fallback logic.',
+            '',
+        ].join('\n'),
+    },
+    ...DEFAULT_COMPOSITIONS,
+];
+const BOOTSTRAP_TARGETS = [
+    {
+        localRelativePath: 'facets/persona/coder.md',
+        remoteRelativePath: 'personas/coder.md',
+    },
+    {
+        localRelativePath: 'facets/knowledge/architecture.md',
+        remoteRelativePath: 'knowledge/architecture.md',
+    },
+    {
+        localRelativePath: 'facets/knowledge/frontend.md',
+        remoteRelativePath: 'knowledge/frontend.md',
+    },
+    {
+        localRelativePath: 'facets/knowledge/backend.md',
+        remoteRelativePath: 'knowledge/backend.md',
+    },
+    {
+        localRelativePath: 'facets/policies/coding.md',
+        remoteRelativePath: 'policies/coding.md',
+    },
+    {
+        localRelativePath: 'facets/policies/ai-antipattern.md',
+        remoteRelativePath: 'policies/ai-antipattern.md',
+    },
+];
+function resolveFetchImpl(fetchImpl) {
+    if (fetchImpl) {
+        return fetchImpl;
+    }
+    if (typeof globalThis.fetch !== 'function') {
+        throw new Error('Global fetch is not available');
+    }
+    return globalThis.fetch.bind(globalThis);
+}
+async function fetchBootstrapContent(remoteRelativePath, fetchImpl) {
+    const response = await fetchImpl(`${TAKT_BOOTSTRAP_BASE_URL}/${remoteRelativePath}`);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch bootstrap facet: ${remoteRelativePath} (status: ${response.status})`);
+    }
+    return response.text();
+}
+export function listPullSampleTargetPaths(homeDir) {
+    const facetedRoot = getFacetedRoot(homeDir);
+    return BOOTSTRAP_TARGETS.map(target => join(facetedRoot, target.localRelativePath));
+}
+async function bootstrapDefaultFacets(facetedRoot, fetchImpl, overwrite) {
+    for (const target of BOOTSTRAP_TARGETS) {
+        const targetPath = join(facetedRoot, target.localRelativePath);
+        if (existsSync(targetPath) && !overwrite) {
+            continue;
+        }
+        const content = await fetchBootstrapContent(target.remoteRelativePath, fetchImpl);
+        mkdirSync(dirname(targetPath), { recursive: true });
+        writeFileSync(targetPath, content, 'utf-8');
+    }
+}
+export async function initializeFacetedHome(options) {
+    const facetedRoot = getFacetedRoot(options.homeDir);
+    ensureConfigFile(options.homeDir);
+    const facetsRoot = join(facetedRoot, 'facets');
+    const compositionsRoot = join(facetedRoot, 'compositions');
+    const templatesRoot = join(facetedRoot, 'templates');
+    mkdirSync(facetsRoot, { recursive: true });
+    mkdirSync(compositionsRoot, { recursive: true });
+    mkdirSync(templatesRoot, { recursive: true });
+    for (const dirName of REQUIRED_FACET_DIRS) {
+        mkdirSync(join(facetsRoot, dirName), { recursive: true });
+    }
+    for (const template of DEFAULT_TEMPLATES) {
+        const targetPath = join(facetedRoot, template.relativePath);
+        if (!existsSync(targetPath)) {
+            mkdirSync(dirname(targetPath), { recursive: true });
+            writeFileSync(targetPath, template.content, 'utf-8');
+        }
+    }
+}
+export async function pullSampleFacets(options) {
+    await initializeFacetedHome({ homeDir: options.homeDir });
+    const facetedRoot = getFacetedRoot(options.homeDir);
+    await bootstrapDefaultFacets(facetedRoot, resolveFetchImpl(options.fetchImpl), options.overwrite ?? false);
+}
+//# sourceMappingURL=index.js.map

package/dist/init/index.js.map

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

package/dist/output/index.d.ts

@@ -0,0 +1,10 @@
+import type { ComposedPrompt } from '../types.js';
+export declare function resolveOutputDirectory(inputValue: string, defaultDirectory: string): string;
+export declare function formatCombinedOutput(composed: ComposedPrompt): string;
+export declare function writeComposeOutput(options: {
+    outputDir: string;
+    fileName: string;
+    content: string;
+    overwrite: boolean;
+}): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/output/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAM3F;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CASrE;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmDlB"}

package/dist/output/index.js

@@ -0,0 +1,67 @@
+import { closeSync, constants, mkdirSync, openSync, realpathSync, writeFileSync } from 'node:fs';
+import { basename, dirname, resolve, sep } from 'node:path';
+export function resolveOutputDirectory(inputValue, defaultDirectory) {
+    const trimmed = inputValue.trim();
+    if (trimmed.length === 0) {
+        return defaultDirectory;
+    }
+    return resolve(defaultDirectory, trimmed);
+}
+export function formatCombinedOutput(composed) {
+    const parts = [];
+    if (composed.systemPrompt.length > 0) {
+        parts.push(composed.systemPrompt);
+    }
+    if (composed.userMessage.length > 0) {
+        parts.push(composed.userMessage);
+    }
+    return parts.join('\n\n') + '\n';
+}
+export async function writeComposeOutput(options) {
+    const outputDir = resolve(options.outputDir);
+    mkdirSync(outputDir, { recursive: true });
+    const outputDirRealPath = realpathSync(outputDir);
+    if (basename(options.fileName) !== options.fileName) {
+        throw new Error(`Output file name must not include path segments: ${options.fileName}`);
+    }
+    const outputPath = resolve(outputDir, options.fileName);
+    if (!(outputPath === outputDir || outputPath.startsWith(`${outputDir}${sep}`))) {
+        throw new Error(`Output path escapes target directory: ${options.fileName}`);
+    }
+    const outputParentDirectory = dirname(outputPath);
+    mkdirSync(outputParentDirectory, { recursive: true });
+    const outputParentRealPath = realpathSync(outputParentDirectory);
+    if (!(outputParentRealPath === outputDirRealPath || outputParentRealPath.startsWith(`${outputDirRealPath}${sep}`))) {
+        throw new Error(`Output path escapes target directory: ${options.fileName}`);
+    }
+    const openFlags = constants.O_WRONLY
+        | constants.O_CREAT
+        | (options.overwrite ? constants.O_TRUNC : constants.O_EXCL)
+        | constants.O_NOFOLLOW;
+    let fileDescriptor;
+    try {
+        fileDescriptor = openSync(outputPath, openFlags, 0o600);
+    }
+    catch (error) {
+        const errorCode = error.code;
+        if (errorCode === 'ELOOP') {
+            throw new Error(`Symbolic links are not allowed for output file: ${outputPath}`);
+        }
+        if (errorCode === 'EEXIST' && !options.overwrite) {
+            throw new Error(`Output file exists and overwrite was cancelled: ${outputPath}`);
+        }
+        throw error;
+    }
+    try {
+        writeFileSync(fileDescriptor, options.content, 'utf-8');
+    }
+    finally {
+        closeSync(fileDescriptor);
+    }
+    const outputRealPath = realpathSync(outputPath);
+    if (!(outputRealPath === outputDirRealPath || outputRealPath.startsWith(`${outputDirRealPath}${sep}`))) {
+        throw new Error(`Output path escapes target directory: ${options.fileName}`);
+    }
+    return outputPath;
+}
+//# sourceMappingURL=index.js.map

package/dist/output/index.js.map

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

package/dist/prompt-payload.d.ts

@@ -0,0 +1,8 @@
+import type { ComposeDefinition, ComposedPromptPayload, ComposeOptions } from './types.js';
+export declare function composePromptPayload(params: {
+    definition: ComposeDefinition;
+    definitionDir: string;
+    facetsRoot: string;
+    composeOptions: ComposeOptions;
+}): ComposedPromptPayload;
+//# sourceMappingURL=prompt-payload.d.ts.map

package/dist/prompt-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-payload.d.ts","sourceRoot":"","sources":["../src/prompt-payload.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,cAAc,EAAa,MAAM,YAAY,CAAC;AAmBtG,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,UAAU,EAAE,iBAAiB,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;CAChC,GAAG,qBAAqB,CAYxB"}

package/dist/prompt-payload.js

@@ -0,0 +1,24 @@
+import { compose } from './compose.js';
+import { buildFacetSet, resolveDefinitionSections } from './cli/skill-renderer.js';
+function buildCopyFiles(params) {
+    const resolved = resolveDefinitionSections(params);
+    return {
+        persona: [resolved.persona.path],
+        knowledge: resolved.knowledge.map(section => section.path),
+        policies: resolved.policies.map(section => section.path),
+        instructions: resolved.instruction && 'path' in resolved.instruction ? [resolved.instruction.path] : [],
+    };
+}
+export function composePromptPayload(params) {
+    const facetSet = buildFacetSet(params);
+    const composed = compose(facetSet, {
+        ...params.composeOptions,
+        userMessageOrder: params.definition.order,
+    });
+    return {
+        systemPrompt: composed.systemPrompt,
+        userPrompt: composed.userMessage,
+        copyFiles: buildCopyFiles(params),
+    };
+}
+//# sourceMappingURL=prompt-payload.js.map

package/dist/prompt-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-payload.js","sourceRoot":"","sources":["../src/prompt-payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEnF,SAAS,cAAc,CAAC,MAIvB;IACC,MAAM,QAAQ,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAEnD,OAAO;QACL,OAAO,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;QAChC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QAC1D,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACxD,YAAY,EACV,QAAQ,CAAC,WAAW,IAAI,MAAM,IAAI,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;KAC5F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAKpC;IACC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE;QACjC,GAAG,MAAM,CAAC,cAAc;QACxB,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK;KAC1C,CAAC,CAAC;IAEH,OAAO;QACL,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,UAAU,EAAE,QAAQ,CAAC,WAAW;QAChC,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Facet reference resolution utilities.
+ *
+ * Resolves facet names / paths / content from section maps
+ * and candidate directories. Directory construction is delegated
+ * to the caller (TAKT provides project/global/builtin dirs).
+ *
+ * This module depends only on node:fs, node:os, node:path.
+ */
+/** Pre-resolved section maps passed to movement normalization. */
+export interface PieceSections {
+    /** Persona name -> file path (raw, not content-resolved) */
+    personas?: Record<string, string>;
+    /** Policy name -> resolved content */
+    resolvedPolicies?: Record<string, string>;
+    /** Knowledge name -> resolved content */
+    resolvedKnowledge?: Record<string, string>;
+    /** Instruction name -> resolved content */
+    resolvedInstructions?: Record<string, string>;
+    /** Report format name -> resolved content */
+    resolvedReportFormats?: Record<string, string>;
+}
+/**
+ * Check if a spec looks like a resource path (vs. a facet name).
+ * Paths start with './', '../', '/', '~' or end with '.md'.
+ */
+export declare function isResourcePath(spec: string): boolean;
+/**
+ * Resolve a facet name to its file path by scanning candidate directories.
+ *
+ * The caller builds the candidate list (e.g. project/.takt/{kind},
+ * ~/.takt/{kind}, builtins/{lang}/{kind}) and passes it in.
+ *
+ * @returns Absolute file path if found, undefined otherwise.
+ */
+export declare function resolveFacetPath(name: string, candidateDirs: readonly string[]): string | undefined;
+/**
+ * Resolve a facet name to its file content via candidate directories.
+ *
+ * @returns File content if found, undefined otherwise.
+ */
+export declare function resolveFacetByName(name: string, candidateDirs: readonly string[]): string | undefined;
+/** Resolve a resource spec to an absolute file path. */
+export declare function resolveResourcePath(spec: string, pieceDir: string): string;
+/**
+ * Resolve a resource spec to its file content.
+ * If the spec ends with .md and the file exists, returns file content.
+ * Otherwise returns the spec as-is (treated as inline content).
+ */
+export declare function resolveResourceContent(spec: string | undefined, pieceDir: string): string | undefined;
+/**
+ * Resolve a section reference to content.
+ * Looks up ref in resolvedMap first, then falls back to path resolution.
+ * If candidateDirs are provided and ref is a name (not a path),
+ * falls back to facet resolution via candidate directories.
+ */
+export declare function resolveRefToContent(ref: string, resolvedMap: Record<string, string> | undefined, pieceDir: string, candidateDirs?: readonly string[]): string | undefined;
+/** Resolve multiple references to content strings (for fields that accept string | string[]). */
+export declare function resolveRefList(refs: string | string[] | undefined, resolvedMap: Record<string, string> | undefined, pieceDir: string, candidateDirs?: readonly string[]): string[] | undefined;
+/** Resolve a piece-level section map (each value resolved to file content or inline). */
+export declare function resolveSectionMap(raw: Record<string, string> | undefined, pieceDir: string): Record<string, string> | undefined;
+/** Extract display name from persona path (e.g., "coder.md" -> "coder"). */
+export declare function extractPersonaDisplayName(personaPath: string): string;
+/**
+ * Resolve persona from YAML field to spec + absolute path.
+ *
+ * Candidate directories for name-based lookup are provided by the caller.
+ */
+export declare function resolvePersona(rawPersona: string | undefined, sections: PieceSections, pieceDir: string, candidateDirs?: readonly string[]): {
+    personaSpec?: string;
+    personaPath?: string;
+};
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,6CAA6C;IAC7C,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQpD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,MAAM,GAAG,SAAS,CAQpB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,MAAM,GAAG,SAAS,CAMpB;AAED,wDAAwD;AACxD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAOpB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC/C,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAChC,MAAM,GAAG,SAAS,CAcpB;AAED,iGAAiG;AACjG,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,EACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC/C,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAChC,MAAM,EAAE,GAAG,SAAS,CAStB;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACvC,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAQpC;AAED,4EAA4E;AAC5E,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAChC;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CA8BhD"}

package/dist/resolve.js

@@ -0,0 +1,160 @@
+/**
+ * Facet reference resolution utilities.
+ *
+ * Resolves facet names / paths / content from section maps
+ * and candidate directories. Directory construction is delegated
+ * to the caller (TAKT provides project/global/builtin dirs).
+ *
+ * This module depends only on node:fs, node:os, node:path.
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, basename } from 'node:path';
+/**
+ * Check if a spec looks like a resource path (vs. a facet name).
+ * Paths start with './', '../', '/', '~' or end with '.md'.
+ */
+export function isResourcePath(spec) {
+    return (spec.startsWith('./') ||
+        spec.startsWith('../') ||
+        spec.startsWith('/') ||
+        spec.startsWith('~') ||
+        spec.endsWith('.md'));
+}
+/**
+ * Resolve a facet name to its file path by scanning candidate directories.
+ *
+ * The caller builds the candidate list (e.g. project/.takt/{kind},
+ * ~/.takt/{kind}, builtins/{lang}/{kind}) and passes it in.
+ *
+ * @returns Absolute file path if found, undefined otherwise.
+ */
+export function resolveFacetPath(name, candidateDirs) {
+    for (const dir of candidateDirs) {
+        const filePath = join(dir, `${name}.md`);
+        if (existsSync(filePath)) {
+            return filePath;
+        }
+    }
+    return undefined;
+}
+/**
+ * Resolve a facet name to its file content via candidate directories.
+ *
+ * @returns File content if found, undefined otherwise.
+ */
+export function resolveFacetByName(name, candidateDirs) {
+    const filePath = resolveFacetPath(name, candidateDirs);
+    if (filePath) {
+        return readFileSync(filePath, 'utf-8');
+    }
+    return undefined;
+}
+/** Resolve a resource spec to an absolute file path. */
+export function resolveResourcePath(spec, pieceDir) {
+    if (spec.startsWith('./'))
+        return join(pieceDir, spec.slice(2));
+    if (spec.startsWith('~'))
+        return join(homedir(), spec.slice(1));
+    if (spec.startsWith('/'))
+        return spec;
+    return join(pieceDir, spec);
+}
+/**
+ * Resolve a resource spec to its file content.
+ * If the spec ends with .md and the file exists, returns file content.
+ * Otherwise returns the spec as-is (treated as inline content).
+ */
+export function resolveResourceContent(spec, pieceDir) {
+    if (spec == null)
+        return undefined;
+    if (spec.endsWith('.md')) {
+        const resolved = resolveResourcePath(spec, pieceDir);
+        if (existsSync(resolved))
+            return readFileSync(resolved, 'utf-8');
+    }
+    return spec;
+}
+/**
+ * Resolve a section reference to content.
+ * Looks up ref in resolvedMap first, then falls back to path resolution.
+ * If candidateDirs are provided and ref is a name (not a path),
+ * falls back to facet resolution via candidate directories.
+ */
+export function resolveRefToContent(ref, resolvedMap, pieceDir, candidateDirs) {
+    const mapped = resolvedMap?.[ref];
+    if (mapped)
+        return mapped;
+    if (isResourcePath(ref)) {
+        return resolveResourceContent(ref, pieceDir);
+    }
+    if (candidateDirs) {
+        const facetContent = resolveFacetByName(ref, candidateDirs);
+        if (facetContent !== undefined)
+            return facetContent;
+    }
+    return resolveResourceContent(ref, pieceDir);
+}
+/** Resolve multiple references to content strings (for fields that accept string | string[]). */
+export function resolveRefList(refs, resolvedMap, pieceDir, candidateDirs) {
+    if (refs == null)
+        return undefined;
+    const list = Array.isArray(refs) ? refs : [refs];
+    const contents = [];
+    for (const ref of list) {
+        const content = resolveRefToContent(ref, resolvedMap, pieceDir, candidateDirs);
+        if (content)
+            contents.push(content);
+    }
+    return contents.length > 0 ? contents : undefined;
+}
+/** Resolve a piece-level section map (each value resolved to file content or inline). */
+export function resolveSectionMap(raw, pieceDir) {
+    if (!raw)
+        return undefined;
+    const resolved = {};
+    for (const [name, value] of Object.entries(raw)) {
+        const content = resolveResourceContent(value, pieceDir);
+        if (content)
+            resolved[name] = content;
+    }
+    return Object.keys(resolved).length > 0 ? resolved : undefined;
+}
+/** Extract display name from persona path (e.g., "coder.md" -> "coder"). */
+export function extractPersonaDisplayName(personaPath) {
+    return basename(personaPath, '.md');
+}
+/**
+ * Resolve persona from YAML field to spec + absolute path.
+ *
+ * Candidate directories for name-based lookup are provided by the caller.
+ */
+export function resolvePersona(rawPersona, sections, pieceDir, candidateDirs) {
+    if (!rawPersona)
+        return {};
+    // If section map has explicit mapping, use it (path-based)
+    const sectionMapping = sections.personas?.[rawPersona];
+    if (sectionMapping) {
+        const resolved = resolveResourcePath(sectionMapping, pieceDir);
+        const personaPath = existsSync(resolved) ? resolved : undefined;
+        return { personaSpec: sectionMapping, personaPath };
+    }
+    // If rawPersona is a path, resolve it directly
+    if (isResourcePath(rawPersona)) {
+        const resolved = resolveResourcePath(rawPersona, pieceDir);
+        const personaPath = existsSync(resolved) ? resolved : undefined;
+        return { personaSpec: rawPersona, personaPath };
+    }
+    // Name-based: try candidate directories
+    if (candidateDirs) {
+        const filePath = resolveFacetPath(rawPersona, candidateDirs);
+        if (filePath) {
+            return { personaSpec: rawPersona, personaPath: filePath };
+        }
+    }
+    // Fallback: try as relative path from pieceDir
+    const resolved = resolveResourcePath(rawPersona, pieceDir);
+    const personaPath = existsSync(resolved) ? resolved : undefined;
+    return { personaSpec: rawPersona, personaPath };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

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

package/dist/scope.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @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
+ */
+/** Parsed components of an @scope reference. */
+export interface ScopeRef {
+    /** GitHub owner (lowercase). */
+    owner: string;
+    /** Repository name (lowercase). */
+    repo: string;
+    /** Facet name. */
+    name: string;
+}
+/**
+ * Return true if the string is an @{owner}/{repo}/{facet-name} scope reference.
+ */
+export declare function isScopeRef(ref: string): boolean;
+/**
+ * Parse an @scope reference into its components.
+ * Normalizes owner and repo to lowercase.
+ *
+ * @param ref - e.g. "@nrslib/takt-fullstack/expert-coder"
+ */
+export declare function parseScopeRef(ref: string): ScopeRef;
+/**
+ * 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 declare function resolveScopeRef(scopeRef: ScopeRef, facetType: string, repertoireDir: string): string;
+/** Validate owner name: must match /^[a-z0-9][a-z0-9-]*$/ */
+export declare function validateScopeOwner(owner: string): void;
+/** Validate repo name: must match /^[a-z0-9][a-z0-9._-]*$/ */
+export declare function validateScopeRepo(repo: string): void;
+/** Validate facet name: must match /^[a-z0-9][a-z0-9-]*$/ */
+export declare function validateScopeFacetName(name: string): void;
+//# sourceMappingURL=scope.d.ts.map

package/dist/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,gDAAgD;AAChD,MAAM,WAAW,QAAQ;IACvB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAKD;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAYnD;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,MAAM,CASR;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAMtD;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMpD;AAED,6DAA6D;AAC7D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMzD"}