@senior-skills/core 1.0.0

package/dist/domain/manifest.js

@@ -0,0 +1,448 @@
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { AgentSkillsError, ErrorCode } from "./errors.js";
+import { validateSkillName } from "./skill-ref.js";
+import { parseRange, parseVersion } from "./version.js";
+import { escapesRoot, normalize } from "./posix-path.js";
+import { IssueCollector } from "./validation.js";
+/**
+ * The package format version. Bumped only for genuinely breaking changes; additive fields
+ * ship as optional under the current number.
+ */
+export const CURRENT_SCHEMA_VERSION = 1;
+export const MANIFEST_FILENAME = 'skill.yaml';
+export const SKILL_ENTRYPOINT = 'SKILL.md';
+export const COMMAND_ENTRYPOINT = 'COMMAND.md';
+export const WORKFLOW_ENTRYPOINT = 'WORKFLOW.js';
+/**
+ * What the package *is*, which decides where an agent stores it and how it is invoked: a
+ * skill is model-selected, a command is user-invoked, a workflow is a script the agent runs
+ * by name. Everything else about the format — manifest, integrity, dependencies, receipts —
+ * is identical across kinds.
+ */
+export const PACKAGE_KINDS = ['skill', 'command', 'workflow'];
+/** Packages published before `kind` existed are skills. */
+export const DEFAULT_PACKAGE_KIND = 'skill';
+/** The agent-facing entrypoint document for a kind. */
+export function entrypointFor(kind) {
+    if (kind === 'command')
+        return COMMAND_ENTRYPOINT;
+    if (kind === 'workflow')
+        return WORKFLOW_ENTRYPOINT;
+    return SKILL_ENTRYPOINT;
+}
+const KNOWN_TOP_LEVEL_KEYS = new Set([
+    'schemaVersion',
+    'name',
+    'kind',
+    'version',
+    'description',
+    'license',
+    'keywords',
+    'authors',
+    'homepage',
+    'repository',
+    'compatibility',
+    'files',
+    'dependencies',
+    'optionalDependencies',
+    'suggests',
+    'capabilities',
+    'integrity',
+    'signatures',
+    'agentOverrides',
+]);
+function defaultFiles(kind) {
+    return [entrypointFor(kind), MANIFEST_FILENAME];
+}
+/**
+ * Parses and normalises a `skill.yaml`.
+ *
+ * Throws {@link AgentSkillsError} for anything that makes the document unusable, and
+ * returns non-fatal findings as issues so `validate` can show several problems at once
+ * instead of one per run.
+ */
+export function parseManifest(text, options = {}) {
+    const source = options.source ?? MANIFEST_FILENAME;
+    const issues = new IssueCollector();
+    let raw;
+    try {
+        raw = parseYaml(text);
+    }
+    catch (cause) {
+        throw new AgentSkillsError(ErrorCode.INVALID_MANIFEST, `Could not parse ${source}`, {
+            details: [cause instanceof Error ? cause.message : String(cause)],
+            hints: ['skill.yaml must be valid YAML'],
+            cause,
+            data: { source },
+        });
+    }
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new AgentSkillsError(ErrorCode.INVALID_MANIFEST, `${source} must be a YAML mapping`, {
+            hints: ['Run `senior-skills create <name>` to generate a valid starting point'],
+            data: { source },
+        });
+    }
+    const doc = raw;
+    const schemaVersion = readSchemaVersion(doc, source);
+    const kind = readKind(doc, issues);
+    const name = readRequiredString(doc, 'name', source);
+    const nameProblems = validateSkillName(name);
+    for (const problem of nameProblems) {
+        issues.error('manifest.name.invalid', 'name', `Invalid name "${name}": ${problem}`);
+    }
+    const version = parseVersion(readRequiredString(doc, 'version', source), source);
+    const description = readRequiredString(doc, 'description', source).trim();
+    if (description.length < 10) {
+        issues.warn('manifest.description.short', 'description', 'Description is very short; agents route on it, so say what the skill covers and when to use it');
+    }
+    const files = readFiles(doc, kind, issues);
+    const dependencies = readDependencies(doc, 'dependencies', name, source, issues);
+    const optionalDependencies = readDependencies(doc, 'optionalDependencies', name, source, issues);
+    const suggests = readSuggests(doc, name, issues);
+    for (const key of Object.keys(doc)) {
+        if (KNOWN_TOP_LEVEL_KEYS.has(key))
+            continue;
+        const message = `Unknown field "${key}"`;
+        const hint = 'Remove it, or upgrade the CLI if it belongs to a newer package format';
+        if (options.strict) {
+            issues.error('manifest.unknownField', key, message, hint);
+        }
+        else {
+            issues.warn('manifest.unknownField', key, message, hint);
+        }
+    }
+    const manifest = {
+        schemaVersion,
+        name,
+        kind,
+        version,
+        description,
+        ...optionalString(doc, 'license'),
+        keywords: readStringArray(doc, 'keywords', issues),
+        authors: readAuthors(doc, issues),
+        ...optionalString(doc, 'homepage'),
+        ...readRepository(doc, issues),
+        compatibility: readCompatibility(doc, source, issues),
+        files,
+        dependencies,
+        optionalDependencies,
+        suggests,
+        capabilities: readStringArray(doc, 'capabilities', issues),
+        ...optionalString(doc, 'integrity'),
+        signatures: Array.isArray(doc['signatures']) ? doc['signatures'] : [],
+        agentOverrides: readAgentOverrides(doc, issues),
+    };
+    if (manifest.license === undefined) {
+        issues.warn('manifest.license.missing', 'license', 'No license declared', 'Add an SPDX identifier, e.g. license: Apache-2.0');
+    }
+    return { manifest, issues: issues.all() };
+}
+function readSchemaVersion(doc, source) {
+    const value = doc['schemaVersion'];
+    if (value === undefined)
+        return CURRENT_SCHEMA_VERSION;
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 1) {
+        throw new AgentSkillsError(ErrorCode.INVALID_MANIFEST, `${source}: schemaVersion must be a positive integer`, { data: { source, schemaVersion: value } });
+    }
+    if (value > CURRENT_SCHEMA_VERSION) {
+        throw new AgentSkillsError(ErrorCode.UNSUPPORTED_SCHEMA, `This package uses skill format v${value}, but this CLI understands up to v${CURRENT_SCHEMA_VERSION}`, {
+            hints: ['Upgrade the CLI: npm install -g @senior-skills/cli@latest'],
+            data: { source, schemaVersion: value, supported: CURRENT_SCHEMA_VERSION },
+        });
+    }
+    return value;
+}
+/**
+ * An unknown kind is reported rather than thrown, so `validate` lists it alongside the
+ * package's other problems; treating it as a skill keeps the rest of the checks meaningful.
+ */
+function readKind(doc, issues) {
+    const value = doc['kind'];
+    if (value === undefined)
+        return DEFAULT_PACKAGE_KIND;
+    if (typeof value === 'string' && PACKAGE_KINDS.includes(value)) {
+        return value;
+    }
+    issues.error('manifest.kind.invalid', 'kind', `Unknown kind "${String(value)}"`, `Accepted kinds: ${PACKAGE_KINDS.join(', ')}`);
+    return DEFAULT_PACKAGE_KIND;
+}
+function readRequiredString(doc, key, source) {
+    const value = doc[key];
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new AgentSkillsError(ErrorCode.INVALID_MANIFEST, `${source}: missing required field "${key}"`, {
+            hints: [`Add a non-empty ${key}: to ${source}`],
+            data: { source, field: key },
+        });
+    }
+    return value.trim();
+}
+function optionalString(doc, key) {
+    const value = doc[key];
+    return typeof value === 'string' && value.trim() !== '' ? { [key]: value.trim() } : {};
+}
+function readStringArray(doc, key, issues) {
+    const value = doc[key];
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value)) {
+        issues.error(`manifest.${key}.type`, key, `"${key}" must be a list of strings`);
+        return [];
+    }
+    const result = [];
+    for (const entry of value) {
+        if (typeof entry !== 'string') {
+            issues.error(`manifest.${key}.type`, key, `"${key}" entries must be strings`);
+            continue;
+        }
+        result.push(entry.trim());
+    }
+    return result;
+}
+function readFiles(doc, kind, issues) {
+    const declared = readStringArray(doc, 'files', issues);
+    const files = declared.length > 0 ? declared : defaultFiles(kind);
+    const safe = [];
+    for (const entry of files) {
+        // Path safety is checked at authoring time, not only at extraction time: a manifest
+        // must never be able to *describe* a path that escapes the package.
+        if (entry.startsWith('/') || /^[a-zA-Z]:/.test(entry) || entry.startsWith('\\\\')) {
+            issues.error('manifest.files.absolute', 'files', `"${entry}" is an absolute path; files entries must be relative to the package root`);
+            continue;
+        }
+        if (escapesRoot(entry)) {
+            issues.error('manifest.files.traversal', 'files', `"${entry}" escapes the package root`, 'Remove the ".." segments');
+            continue;
+        }
+        safe.push(normalize(entry.replace(/\/+$/, '')) + (entry.endsWith('/') ? '/' : ''));
+    }
+    const entrypoint = entrypointFor(kind);
+    if (!safe.some((entry) => entry === entrypoint)) {
+        issues.error('manifest.files.missingEntrypoint', 'files', `"files" must include ${entrypoint}`, `Add ${entrypoint} to the files list`);
+    }
+    return safe;
+}
+function readSuggests(doc, selfName, issues) {
+    const value = doc['suggests'];
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value)) {
+        issues.error('manifest.suggests.type', 'suggests', '"suggests" must be a list of skill names');
+        return [];
+    }
+    const seen = new Set();
+    const result = [];
+    for (const entry of value) {
+        if (typeof entry !== 'string') {
+            issues.error('manifest.suggests.type', 'suggests', '"suggests" entries must be skill names, not mappings — a suggestion carries no range');
+            continue;
+        }
+        for (const problem of validateSkillName(entry)) {
+            issues.error('manifest.suggests.name', `suggests.${entry}`, `Invalid skill name: ${problem}`);
+        }
+        if (entry === selfName) {
+            issues.error('manifest.suggests.self', `suggests.${entry}`, 'A skill cannot suggest itself');
+            continue;
+        }
+        if (seen.has(entry)) {
+            issues.error('manifest.suggests.duplicate', `suggests.${entry}`, `Duplicate suggestion "${entry}"`);
+            continue;
+        }
+        seen.add(entry);
+        result.push(entry);
+    }
+    return result;
+}
+function readDependencies(doc, key, selfName, source, issues) {
+    const value = doc[key];
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value)) {
+        issues.error(`manifest.${key}.type`, key, `"${key}" must be a list`);
+        return [];
+    }
+    const seen = new Set();
+    const result = [];
+    for (const entry of value) {
+        if (entry === null || typeof entry !== 'object' || Array.isArray(entry)) {
+            issues.error(`manifest.${key}.type`, key, `"${key}" entries must be mappings with name and version`);
+            continue;
+        }
+        const record = entry;
+        const name = record['name'];
+        const version = record['version'];
+        if (typeof name !== 'string') {
+            issues.error(`manifest.${key}.name`, key, `A ${key} entry is missing "name"`);
+            continue;
+        }
+        for (const problem of validateSkillName(name)) {
+            issues.error(`manifest.${key}.name`, `${key}.${name}`, `Invalid dependency name: ${problem}`);
+        }
+        if (name === selfName) {
+            issues.error(`manifest.${key}.self`, `${key}.${name}`, 'A skill cannot depend on itself');
+            continue;
+        }
+        if (seen.has(name)) {
+            issues.error(`manifest.${key}.duplicate`, `${key}.${name}`, `Duplicate dependency "${name}"`);
+            continue;
+        }
+        seen.add(name);
+        const rangeText = typeof version === 'string' && version.trim() !== '' ? version.trim() : '*';
+        result.push({ name, version: parseRange(rangeText, `${source} ${key}.${name}`) });
+    }
+    return result;
+}
+function readAuthors(doc, issues) {
+    const value = doc['authors'];
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value)) {
+        issues.error('manifest.authors.type', 'authors', '"authors" must be a list');
+        return [];
+    }
+    const authors = [];
+    for (const entry of value) {
+        if (typeof entry === 'string') {
+            authors.push({ name: entry });
+            continue;
+        }
+        if (entry === null || typeof entry !== 'object') {
+            issues.error('manifest.authors.type', 'authors', 'Author entries must be strings or mappings');
+            continue;
+        }
+        const record = entry;
+        if (typeof record['name'] !== 'string') {
+            issues.error('manifest.authors.name', 'authors', 'Author entries need a "name"');
+            continue;
+        }
+        authors.push({
+            name: record['name'],
+            ...optionalString(record, 'email'),
+            ...optionalString(record, 'url'),
+        });
+    }
+    return authors;
+}
+function readRepository(doc, issues) {
+    const value = doc['repository'];
+    if (value === undefined)
+        return {};
+    if (typeof value === 'string')
+        return { repository: { type: 'git', url: value } };
+    if (typeof value !== 'object' || Array.isArray(value)) {
+        issues.error('manifest.repository.type', 'repository', '"repository" must be a mapping or a URL');
+        return {};
+    }
+    const record = value;
+    const url = record['url'];
+    if (typeof url !== 'string') {
+        issues.error('manifest.repository.url', 'repository', '"repository" needs a "url"');
+        return {};
+    }
+    return {
+        repository: {
+            type: typeof record['type'] === 'string' ? record['type'] : 'git',
+            url,
+            ...optionalString(record, 'directory'),
+        },
+    };
+}
+function readCompatibility(doc, source, issues) {
+    const value = doc['compatibility'];
+    if (value === undefined)
+        return [];
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        issues.error('manifest.compatibility.type', 'compatibility', '"compatibility" must be a mapping');
+        return [];
+    }
+    const agents = value['agents'];
+    if (agents === undefined)
+        return [];
+    if (!Array.isArray(agents)) {
+        issues.error('manifest.compatibility.agents', 'compatibility.agents', '"compatibility.agents" must be a list');
+        return [];
+    }
+    const result = [];
+    for (const entry of agents) {
+        if (typeof entry === 'string') {
+            result.push({ id: entry });
+            continue;
+        }
+        if (entry === null || typeof entry !== 'object') {
+            issues.error('manifest.compatibility.agents', 'compatibility.agents', 'Agent entries must be an id string or a mapping with "id"');
+            continue;
+        }
+        const record = entry;
+        const id = record['id'];
+        if (typeof id !== 'string') {
+            issues.error('manifest.compatibility.agents', 'compatibility.agents', 'Agent entries need an "id"');
+            continue;
+        }
+        const minVersion = record['minVersion'];
+        result.push({
+            id,
+            ...(typeof minVersion === 'string'
+                ? { minVersion: parseRange(minVersion, `${source} compatibility.agents.${id}`) }
+                : {}),
+        });
+    }
+    return result;
+}
+function readAgentOverrides(doc, issues) {
+    const value = doc['agentOverrides'];
+    if (value === undefined)
+        return {};
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        issues.error('manifest.agentOverrides.type', 'agentOverrides', '"agentOverrides" must be a mapping');
+        return {};
+    }
+    const result = {};
+    for (const [agentId, override] of Object.entries(value)) {
+        if (typeof override !== 'object' || override === null || Array.isArray(override)) {
+            issues.error('manifest.agentOverrides.type', `agentOverrides.${agentId}`, 'Each agent override must be a mapping');
+            continue;
+        }
+        result[agentId] = override;
+    }
+    return result;
+}
+/** Serialises a manifest back to YAML, omitting empty optional fields to keep files tidy. */
+export function stringifyManifest(manifest) {
+    const doc = {
+        schemaVersion: manifest.schemaVersion,
+        name: manifest.name,
+        version: manifest.version,
+        description: manifest.description,
+    };
+    if (manifest.kind !== DEFAULT_PACKAGE_KIND)
+        doc['kind'] = manifest.kind;
+    if (manifest.license !== undefined)
+        doc['license'] = manifest.license;
+    if (manifest.keywords.length > 0)
+        doc['keywords'] = [...manifest.keywords];
+    if (manifest.authors.length > 0)
+        doc['authors'] = manifest.authors.map((author) => ({ ...author }));
+    if (manifest.homepage !== undefined)
+        doc['homepage'] = manifest.homepage;
+    if (manifest.repository !== undefined)
+        doc['repository'] = { ...manifest.repository };
+    if (manifest.compatibility.length > 0) {
+        doc['compatibility'] = { agents: manifest.compatibility.map((agent) => ({ ...agent })) };
+    }
+    doc['files'] = [...manifest.files];
+    if (manifest.dependencies.length > 0) {
+        doc['dependencies'] = manifest.dependencies.map((dep) => ({ ...dep }));
+    }
+    if (manifest.optionalDependencies.length > 0) {
+        doc['optionalDependencies'] = manifest.optionalDependencies.map((dep) => ({ ...dep }));
+    }
+    if (manifest.suggests.length > 0)
+        doc['suggests'] = [...manifest.suggests];
+    if (manifest.capabilities.length > 0)
+        doc['capabilities'] = [...manifest.capabilities];
+    if (manifest.integrity !== undefined)
+        doc['integrity'] = manifest.integrity;
+    if (Object.keys(manifest.agentOverrides).length > 0)
+        doc['agentOverrides'] = manifest.agentOverrides;
+    return stringifyYaml(doc, { lineWidth: 100, singleQuote: false });
+}
+//# sourceMappingURL=manifest.js.map

package/dist/domain/manifest.js.map

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

package/dist/domain/path-safety.d.ts

@@ -0,0 +1,19 @@
+export declare const MAX_PATH_SEGMENTS = 32;
+export declare const MAX_SEGMENT_LENGTH = 255;
+export type PathSafetyRule = 'empty' | 'controlChars' | 'uncPath' | 'absolute' | 'driveLetter' | 'traversal' | 'tooDeep' | 'segmentTooLong' | 'trailingDotOrSpace' | 'alternateDataStream' | 'illegalCharacter' | 'reservedName';
+export interface PathSafetyViolation {
+    readonly rule: PathSafetyRule;
+    readonly message: string;
+}
+/**
+ * Returns the reason `raw` is unsafe, or undefined when it is acceptable.
+ *
+ * Order matters: UNC is checked before "absolute" because `\\server\share` normalises to
+ * `//server/share`, and the drive-letter check runs only after the colon has been ruled out
+ * as an alternate-data-stream marker on a non-leading segment.
+ */
+export declare function inspectPath(raw: string): PathSafetyViolation | undefined;
+export declare function isSafePath(raw: string): boolean;
+/** Normalised POSIX form. Only meaningful for a path {@link inspectPath} accepted. */
+export declare function normalizeSafePath(raw: string): string;
+//# sourceMappingURL=path-safety.d.ts.map

package/dist/domain/path-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-safety.d.ts","sourceRoot":"","sources":["../../src/domain/path-safety.ts"],"names":[],"mappings":"AA0CA,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,MAAM,MAAM,cAAc,GACtB,OAAO,GACP,cAAc,GACd,SAAS,GACT,UAAU,GACV,aAAa,GACb,WAAW,GACX,SAAS,GACT,gBAAgB,GAChB,oBAAoB,GACpB,qBAAqB,GACrB,kBAAkB,GAClB,cAAc,CAAC;AAEnB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAWD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CA8DxE;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/domain/path-safety.js

@@ -0,0 +1,125 @@
+import { escapesRoot, normalize, segments } from "./posix-path.js";
+/**
+ * The single definition of "is this path safe to turn into a filename".
+ *
+ * It lives in the domain because two very different callers need exactly the same answer:
+ * `validate` (is this package well-formed?) and the installer's extractor (is this archive
+ * hostile?). Keeping two copies meant they drifted — a path like `a:stream` was reported as
+ * "absolute" by one and "alternate data stream" by the other — so there is one copy now and
+ * both callers wrap it.
+ *
+ * Rules are enforced on every platform, not just the one in use: a package that installs
+ * cleanly on Linux and corrupts a Windows machine is a supply-chain bug, not a quirk.
+ */
+const RESERVED_BASENAMES = new Set([
+    'con',
+    'prn',
+    'aux',
+    'nul',
+    'com1',
+    'com2',
+    'com3',
+    'com4',
+    'com5',
+    'com6',
+    'com7',
+    'com8',
+    'com9',
+    'lpt1',
+    'lpt2',
+    'lpt3',
+    'lpt4',
+    'lpt5',
+    'lpt6',
+    'lpt7',
+    'lpt8',
+    'lpt9',
+]);
+const ILLEGAL_CHARACTERS = ['<', '>', '"', '|', '?', '*'];
+export const MAX_PATH_SEGMENTS = 32;
+export const MAX_SEGMENT_LENGTH = 255;
+/** Tested by code point rather than with a regex literal holding raw C0 bytes. */
+function hasControlCharacters(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code < 0x20 || code === 0x7f)
+            return true;
+    }
+    return false;
+}
+/**
+ * Returns the reason `raw` is unsafe, or undefined when it is acceptable.
+ *
+ * Order matters: UNC is checked before "absolute" because `\\server\share` normalises to
+ * `//server/share`, and the drive-letter check runs only after the colon has been ruled out
+ * as an alternate-data-stream marker on a non-leading segment.
+ */
+export function inspectPath(raw) {
+    if (raw.trim() === '') {
+        return { rule: 'empty', message: 'Path is empty' };
+    }
+    if (hasControlCharacters(raw)) {
+        return { rule: 'controlChars', message: 'Path contains control characters' };
+    }
+    // Normalise separators before any structural check: an archive can record `..\\..\\x` and
+    // rely on a POSIX-only check treating backslashes as ordinary characters.
+    const unified = raw.replace(/\\/g, '/');
+    if (raw.startsWith('\\\\') || unified.startsWith('//')) {
+        return { rule: 'uncPath', message: 'Path is a UNC network path' };
+    }
+    if (unified.startsWith('/')) {
+        return { rule: 'absolute', message: 'Path is absolute' };
+    }
+    if (/^[a-zA-Z]:[/\\]/.test(raw)) {
+        return { rule: 'driveLetter', message: 'Path starts with a drive letter' };
+    }
+    if (escapesRoot(unified)) {
+        return { rule: 'traversal', message: 'Path escapes the destination directory' };
+    }
+    const parts = segments(unified);
+    if (parts.length === 0) {
+        return { rule: 'empty', message: 'Path resolves to nothing' };
+    }
+    if (parts.length > MAX_PATH_SEGMENTS) {
+        return { rule: 'tooDeep', message: `Path is more than ${MAX_PATH_SEGMENTS} levels deep` };
+    }
+    for (const segment of parts) {
+        if (segment.length > MAX_SEGMENT_LENGTH) {
+            return {
+                rule: 'segmentTooLong',
+                message: `"${truncate(segment)}" exceeds ${MAX_SEGMENT_LENGTH} characters`,
+            };
+        }
+        if (segment.endsWith('.') || segment.endsWith(' ')) {
+            // Windows silently strips these, so `evil.txt.` and `evil.txt` become the same file —
+            // a way to reach a path that was already checked under a different name.
+            return { rule: 'trailingDotOrSpace', message: `"${segment}" ends with a dot or space` };
+        }
+        if (segment.includes(':')) {
+            return {
+                rule: 'alternateDataStream',
+                message: `"${segment}" addresses an NTFS alternate data stream`,
+            };
+        }
+        for (const character of ILLEGAL_CHARACTERS) {
+            if (segment.includes(character)) {
+                return { rule: 'illegalCharacter', message: `"${segment}" contains "${character}"` };
+            }
+        }
+        if (RESERVED_BASENAMES.has(segment.split('.')[0].toLowerCase())) {
+            return { rule: 'reservedName', message: `"${segment}" is a reserved device name on Windows` };
+        }
+    }
+    return undefined;
+}
+export function isSafePath(raw) {
+    return inspectPath(raw) === undefined;
+}
+/** Normalised POSIX form. Only meaningful for a path {@link inspectPath} accepted. */
+export function normalizeSafePath(raw) {
+    return normalize(raw.replace(/\\/g, '/'));
+}
+function truncate(value) {
+    return value.length > 120 ? `${value.slice(0, 117)}...` : value;
+}
+//# sourceMappingURL=path-safety.js.map

package/dist/domain/path-safety.js.map

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

package/dist/domain/posix-path.d.ts

@@ -0,0 +1,28 @@
+/**
+ * A minimal POSIX-style path helper.
+ *
+ * The domain keeps its own copy rather than importing `node:path` so that `@senior-skills/core`
+ * stays runtime-free: package-relative paths are always POSIX regardless of the host OS, and
+ * a domain that imported `node:path` would silently behave differently on Windows.
+ *
+ * Filesystem-absolute paths are the concern of the `FileSystem` port, not of this module.
+ */
+/** Normalise separators and collapse `.` / `..` segments without touching the filesystem. */
+export declare function normalize(input: string): string;
+export declare function join(...parts: readonly string[]): string;
+export declare function dirname(input: string): string;
+export declare function basename(input: string): string;
+export declare function extname(input: string): string;
+/** Split into non-empty segments. `''` and `'.'` yield an empty list. */
+export declare function segments(input: string): readonly string[];
+/**
+ * True when `candidate` stays inside `root`. Both are treated as POSIX-relative paths;
+ * this is a *lexical* check and is intentionally conservative — the filesystem-level
+ * check (symlinks, real paths) lives in the installer.
+ */
+export declare function isInside(root: string, candidate: string): boolean;
+/** True when the path escapes its own root, i.e. normalising leaves a leading `..`. */
+export declare function escapesRoot(input: string): boolean;
+/** Convert an OS-native path to the POSIX form used inside packages. */
+export declare function toPosix(input: string): string;
+//# sourceMappingURL=posix-path.d.ts.map