@mpfrontend/ai-skills 0.1.0 → 1.0.0

package/dist/index.d.ts

@@ -1,48 +1 @@
-export declare const SKILLS_VERSION = "0.1.0", SKILLS_CLI_VERSION = "0.1.0";
-export declare class SkillsError extends Error {
-    readonly exitCode: number;
-    constructor(message: string, exitCode?: number);
-}
-export declare function skillCatalog(): {
-    version: string;
-    cliVersion: string;
-    skills: {
-        reason?: string;
-        name: string;
-        profile: string;
-        available: boolean;
-    }[];
-};
-type Options = {
-    directory: string;
-    profile?: 'base' | 'design';
-    agent?: 'codex' | 'claude' | 'both';
-    dryRun?: boolean;
-    update?: boolean;
-};
-export declare function installSkills(options: Options): Promise<{
-    ok: boolean;
-    version: string;
-    profile: "base" | "design";
-    agents: ("codex" | "claude")[];
-    dryRun: boolean;
-    changes: {
-        path: string;
-        beforeHash: string | null;
-        afterHash: string;
-    }[];
-    installed: string[];
-    unavailable: {
-        reason?: string;
-        name: string;
-        profile: string;
-        available: boolean;
-    }[];
-}>;
-export declare function checkSkills(directory: string): Promise<{
-    ok: boolean;
-    version: string;
-    checked: number;
-    agents: ("codex" | "claude")[];
-}>;
-export {};
+export declare const SKILLS_VERSION: string, SKILLS_CLI_VERSION: string;

package/dist/index.js

@@ -1,221 +1,3 @@
-import { readFile, lstat, realpath, mkdir, writeFile, rename, unlink, readdir } from 'node:fs/promises';
-import { resolve, join, dirname } from 'node:path';
-import { createHash, randomUUID } from 'node:crypto';
-export const SKILLS_VERSION = '0.1.0', SKILLS_CLI_VERSION = '0.1.0';
-const names = ['scaffold-app', 'implement-feature', 'integrate-openapi', 'form-from-api', 'table-from-api',
-    'integrate-auth', 'apply-access', 'use-ui', 'configure-i18n', 'configure-theme', 'integrate-realtime',
-    'verify-frontend', 'upgrade-project', 'prepare-release', 'import-design-system', 'sync-design-tokens',
-    'reconcile-design-components', 'review-design-drift'];
-const available = new Set(names);
-const hash = (text) => createHash('sha256').update(text).digest('hex');
-export class SkillsError extends Error {
-    exitCode;
-    constructor(message, exitCode = 4) {
-        super(message);
-        this.exitCode = exitCode;
-    }
-}
-export function skillCatalog() {
-    return { version: SKILLS_VERSION, cliVersion: SKILLS_CLI_VERSION, skills: names.map((name, index) => ({
-            name: 'mpfrontend-' + name, profile: index < 14 ? 'base' : 'design', available: available.has(name),
-            ...(available.has(name) ? {} : { reason: 'CAPABILITY_AND_BEHAVIORAL_ACCEPTANCE_PENDING' })
-        })) };
-}
-const lockPath = '.mpfrontend/skills-lock.json';
-const mutexPath = '.mpfrontend/skills-install.lock';
-async function content(root, path) {
-    let current = root;
-    for (const part of path.split('/')) {
-        current = join(current, part);
-        try {
-            const info = await lstat(current);
-            if (info.isSymbolicLink())
-                throw new SkillsError('SKILL_PATH_SYMLINK');
-            if (current !== join(root, path) && !info.isDirectory())
-                throw new SkillsError('SKILL_PARENT_NOT_DIRECTORY');
-        }
-        catch (error) {
-            if (error.code === 'ENOENT')
-                return undefined;
-            throw error;
-        }
-    }
-    try {
-        return await readFile(current, 'utf8');
-    }
-    catch (error) {
-        if (error.code === 'ENOENT')
-            return undefined;
-        throw error;
-    }
-}
-function parseLock(bytes) {
-    if (bytes === undefined)
-        return undefined;
-    try {
-        const value = JSON.parse(bytes);
-        if (value.generator !== 'MPFrontendSkills' || value.schemaVersion !== 1 || typeof value.version !== 'string' || typeof value.cliVersion !== 'string' || !['base', 'design'].includes(value.profile) || !Array.isArray(value.agents) || !value.agents.length || value.agents.length > 2 || new Set(value.agents).size !== value.agents.length || value.agents.some(v => !['codex', 'claude'].includes(v)) || !value.files || typeof value.files !== 'object' || Array.isArray(value.files))
-            throw new Error();
-        for (const [path, digest] of Object.entries(value.files))
-            if (!/^\.(?:agents|claude)\/skills\/mpfrontend-[a-z0-9-]+\/SKILL\.md$/.test(path) || !/^([a-f0-9]{64})$/.test(digest))
-                throw new Error();
-        return value;
-    }
-    catch {
-        throw new SkillsError('INVALID_SKILLS_LOCK');
-    }
-}
-/**
- * The `mpfrontend-` prefix is reserved for the catalog. A consumer's own project and domain skills live
- * beside the installed ones under another prefix; the installer never reads, changes or removes them.
- */
-async function refuseReservedNames(root) {
-    const catalog = new Set(names.map(name => 'mpfrontend-' + name));
-    for (const base of ['.agents/skills', '.claude/skills']) {
-        const parent = join(root, base);
-        try {
-            if (!(await lstat(parent)).isDirectory())
-                continue;
-        }
-        catch (error) {
-            if (error.code === 'ENOENT')
-                continue;
-            throw error;
-        }
-        for (const entry of await readdir(parent))
-            if (entry.startsWith('mpfrontend-') && !catalog.has(entry))
-                throw new SkillsError('RESERVED_SKILL_NAME:' + base + '/' + entry, 3);
-    }
-}
-export async function installSkills(options) {
-    const profile = options.profile ?? 'base', agent = options.agent ?? 'both';
-    if (!['base', 'design'].includes(profile) || !['codex', 'claude', 'both'].includes(agent))
-        throw new SkillsError('INVALID_SKILL_PROFILE_OR_AGENT', 2);
-    const root = await realpath(resolve(options.directory)), previousLock = await content(root, lockPath), lock = parseLock(previousLock);
-    if (await content(root, mutexPath) !== undefined)
-        throw new SkillsError('SKILLS_INSTALL_BUSY');
-    if (options.update && !lock)
-        throw new SkillsError('SKILLS_NOT_INSTALLED', 2);
-    // Updates preserve the installed selection unless the caller explicitly changes it.
-    const selectedProfile = options.profile ?? lock?.profile ?? profile;
-    const agents = options.agent ? (agent === 'both' ? ['codex', 'claude'] : [agent]) : lock?.agents ?? ['codex', 'claude'];
-    const catalog = skillCatalog(), selected = catalog.skills.filter(s => selectedProfile === 'design' || s.profile === 'base');
-    const desired = new Map(), before = new Map();
-    const files = { ...lock?.files };
-    for (const skill of selected.filter(s => s.available)) {
-        const source = await readFile(new URL('../skills/' + skill.name + '/SKILL.md', import.meta.url), 'utf8');
-        for (const target of agents) {
-            const path = (target === 'codex' ? '.agents' : '.claude') + '/skills/' + skill.name + '/SKILL.md';
-            const old = await content(root, path);
-            if (old !== undefined && (!lock?.files[path] || hash(old) !== lock.files[path]))
-                throw new SkillsError('MODIFIED_OR_UNOWNED_SKILL:' + path);
-            before.set(path, old);
-            files[path] = hash(source);
-            if (old !== source)
-                desired.set(path, source);
-        }
-    }
-    await refuseReservedNames(root);
-    const next = { generator: 'MPFrontendSkills', schemaVersion: 1, version: SKILLS_VERSION, cliVersion: SKILLS_CLI_VERSION, profile: selectedProfile, agents, files };
-    const encoded = JSON.stringify(next, null, 2) + '\n';
-    before.set(lockPath, previousLock);
-    if (previousLock !== encoded)
-        desired.set(lockPath, encoded);
-    const changes = [...desired].map(([path, text]) => ({ path, beforeHash: before.get(path) === undefined ? null : hash(before.get(path)), afterHash: hash(text) }));
-    if (!options.dryRun) {
-        const staged = new Map(), replaced = [];
-        const owner = randomUUID();
-        let acquired = false;
-        try {
-            await mkdir(join(root, '.mpfrontend'), { recursive: true });
-            await content(root, mutexPath);
-            try {
-                await writeFile(join(root, mutexPath), owner, { flag: 'wx' });
-                acquired = true;
-            }
-            catch (error) {
-                if (error.code === 'EEXIST')
-                    throw new SkillsError('SKILLS_INSTALL_BUSY');
-                throw error;
-            }
-            for (const [path, text] of desired) {
-                if (await content(root, path) !== before.get(path))
-                    throw new SkillsError('CONCURRENT_SKILL_EDIT:' + path);
-                await mkdir(dirname(join(root, path)), { recursive: true });
-                const stage = join(dirname(join(root, path)), '.mpfrontend-' + randomUUID());
-                await writeFile(stage, text, { flag: 'wx' });
-                staged.set(path, stage);
-            }
-            // Lock is written last. No AGENTS.md, CLAUDE.md or unrelated skill is altered.
-            for (const [path, stage] of staged) {
-                const current = await content(root, path);
-                if (current !== before.get(path))
-                    throw new SkillsError('CONCURRENT_SKILL_EDIT:' + path);
-                await rename(stage, join(root, path));
-                staged.delete(path);
-                replaced.push(path);
-            }
-        }
-        catch (error) {
-            const conflicts = [];
-            for (const path of replaced.reverse()) {
-                // A second agent's edit is never overwritten by rollback, even on a failed install.
-                if (await content(root, path) !== desired.get(path)) {
-                    conflicts.push(path);
-                    continue;
-                }
-                const old = before.get(path);
-                if (old === undefined)
-                    await unlink(join(root, path));
-                else
-                    await writeFile(join(root, path), old);
-            }
-            if (conflicts.length)
-                throw new SkillsError('SKILL_ROLLBACK_CONFLICT:' + conflicts.join(','));
-            throw error;
-        }
-        finally {
-            for (const path of staged.values())
-                await unlink(path).catch(() => undefined);
-            if (acquired && await content(root, mutexPath) === owner)
-                await unlink(join(root, mutexPath));
-        }
-    }
-    return { ok: true, version: SKILLS_VERSION, profile: selectedProfile, agents, dryRun: options.dryRun ?? false, changes,
-        installed: selected.filter(s => s.available).map(s => s.name), unavailable: selected.filter(s => !s.available) };
-}
-export async function checkSkills(directory) {
-    const root = await realpath(resolve(directory));
-    if (await content(root, mutexPath) !== undefined)
-        throw new SkillsError('SKILLS_INSTALL_BUSY');
-    const lock = parseLock(await content(root, lockPath));
-    if (!lock)
-        throw new SkillsError('SKILLS_NOT_INSTALLED', 2);
-    if (lock.version !== SKILLS_VERSION || lock.cliVersion !== SKILLS_CLI_VERSION)
-        throw new SkillsError('SKILLS_VERSION_MISMATCH', 3);
-    await refuseReservedNames(root);
-    const catalog = skillCatalog();
-    let checked = 0;
-    for (const skill of catalog.skills.filter(s => s.available && (lock.profile === 'design' || s.profile === 'base')))
-        for (const agent of lock.agents) {
-            const path = (agent === 'codex' ? '.agents' : '.claude') + '/skills/' + skill.name + '/SKILL.md';
-            if (!lock.files[path])
-                throw new SkillsError('INCOMPLETE_SKILLS_LOCK:' + path, 3);
-        }
-    for (const [path, digest] of Object.entries(lock.files)) {
-        const old = await content(root, path);
-        if (old === undefined || hash(old) !== digest)
-            throw new SkillsError('INSTALLED_SKILL_DRIFT:' + path, 3);
-        const name = path.split('/')[2], skill = catalog.skills.find(s => s.name === name);
-        if (!skill?.available)
-            throw new SkillsError('UNAVAILABLE_INSTALLED_SKILL:' + name, 3);
-        const source = await readFile(new URL('../skills/' + name + '/SKILL.md', import.meta.url), 'utf8');
-        if (hash(source) !== digest)
-            throw new SkillsError('SKILLS_SOURCE_DRIFT:' + name, 3);
-        checked++;
-    }
-    if (!checked)
-        throw new SkillsError('EMPTY_SKILLS_LOCK', 3);
-    return { ok: true, version: SKILLS_VERSION, checked, agents: lock.agents };
-}
+// The cohort version that the procedures require. The installer and the catalog are for the cohort's own CLI.
+export const SKILLS_VERSION = '1.0.0', SKILLS_CLI_VERSION = '1.0.0';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,MAAM,CAAC,MAAM,cAAc,GAAQ,OAAO,EAAC,kBAAkB,GAAQ,OAAO,CAAC"}

package/dist/internal.d.ts

@@ -0,0 +1 @@
+export { checkSkills, installSkills, skillCatalog, SkillsError } from './skills.js';

package/dist/internal.js

@@ -0,0 +1,3 @@
+// For the cohort's own packages: outside the compatibility guarantee (README "Versioning").
+export { checkSkills, installSkills, skillCatalog, SkillsError } from './skills.js';
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,EAAC,WAAW,EAAC,aAAa,EAAC,YAAY,EAAC,WAAW,EAAC,MAAM,aAAa,CAAC"}

package/dist/skills.d.ts

@@ -0,0 +1,47 @@
+export declare class SkillsError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+export declare function skillCatalog(): {
+    version: string;
+    cliVersion: string;
+    skills: {
+        reason?: string;
+        name: string;
+        profile: string;
+        available: boolean;
+    }[];
+};
+type Options = {
+    directory: string;
+    profile?: 'base' | 'design';
+    agent?: 'codex' | 'claude' | 'both';
+    dryRun?: boolean;
+    update?: boolean;
+};
+export declare function installSkills(options: Options): Promise<{
+    ok: boolean;
+    version: string;
+    profile: "base" | "design";
+    agents: ("codex" | "claude")[];
+    dryRun: boolean;
+    changes: {
+        path: string;
+        beforeHash: string | null;
+        afterHash: string;
+    }[];
+    installed: string[];
+    unavailable: {
+        reason?: string;
+        name: string;
+        profile: string;
+        available: boolean;
+    }[];
+}>;
+export declare function checkSkills(directory: string): Promise<{
+    ok: boolean;
+    version: string;
+    checked: number;
+    agents: ("codex" | "claude")[];
+}>;
+export {};

package/dist/skills.js

@@ -0,0 +1,221 @@
+import { readFile, lstat, realpath, mkdir, writeFile, rename, unlink, readdir } from 'node:fs/promises';
+import { resolve, join, dirname } from 'node:path';
+import { createHash, randomUUID } from 'node:crypto';
+import { SKILLS_VERSION, SKILLS_CLI_VERSION } from './index.js';
+const names = ['scaffold-app', 'implement-feature', 'integrate-openapi', 'form-from-api', 'table-from-api',
+    'integrate-auth', 'apply-access', 'use-ui', 'configure-i18n', 'configure-theme', 'integrate-realtime',
+    'verify-frontend', 'upgrade-project', 'prepare-release', 'import-design-system', 'sync-design-tokens',
+    'reconcile-design-components', 'review-design-drift'];
+const available = new Set(names);
+const hash = (text) => createHash('sha256').update(text).digest('hex');
+export class SkillsError extends Error {
+    exitCode;
+    constructor(message, exitCode = 4) {
+        super(message);
+        this.exitCode = exitCode;
+    }
+}
+export function skillCatalog() {
+    return { version: SKILLS_VERSION, cliVersion: SKILLS_CLI_VERSION, skills: names.map((name, index) => ({
+            name: 'mpfrontend-' + name, profile: index < 14 ? 'base' : 'design', available: available.has(name),
+            ...(available.has(name) ? {} : { reason: 'CAPABILITY_AND_BEHAVIORAL_ACCEPTANCE_PENDING' })
+        })) };
+}
+const lockPath = '.mpfrontend/skills-lock.json';
+const mutexPath = '.mpfrontend/skills-install.lock';
+async function content(root, path) {
+    let current = root;
+    for (const part of path.split('/')) {
+        current = join(current, part);
+        try {
+            const info = await lstat(current);
+            if (info.isSymbolicLink())
+                throw new SkillsError('SKILL_PATH_SYMLINK');
+            if (current !== join(root, path) && !info.isDirectory())
+                throw new SkillsError('SKILL_PARENT_NOT_DIRECTORY');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return undefined;
+            throw error;
+        }
+    }
+    try {
+        return await readFile(current, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+}
+function parseLock(bytes) {
+    if (bytes === undefined)
+        return undefined;
+    try {
+        const value = JSON.parse(bytes);
+        if (value.generator !== 'MPFrontendSkills' || value.schemaVersion !== 1 || typeof value.version !== 'string' || typeof value.cliVersion !== 'string' || !['base', 'design'].includes(value.profile) || !Array.isArray(value.agents) || !value.agents.length || value.agents.length > 2 || new Set(value.agents).size !== value.agents.length || value.agents.some(v => !['codex', 'claude'].includes(v)) || !value.files || typeof value.files !== 'object' || Array.isArray(value.files))
+            throw new Error();
+        for (const [path, digest] of Object.entries(value.files))
+            if (!/^\.(?:agents|claude)\/skills\/mpfrontend-[a-z0-9-]+\/SKILL\.md$/.test(path) || !/^([a-f0-9]{64})$/.test(digest))
+                throw new Error();
+        return value;
+    }
+    catch {
+        throw new SkillsError('INVALID_SKILLS_LOCK');
+    }
+}
+/**
+ * The `mpfrontend-` prefix is reserved for the catalog. A consumer's own project and domain skills live
+ * beside the installed ones under another prefix; the installer never reads, changes or removes them.
+ */
+async function refuseReservedNames(root) {
+    const catalog = new Set(names.map(name => 'mpfrontend-' + name));
+    for (const base of ['.agents/skills', '.claude/skills']) {
+        const parent = join(root, base);
+        try {
+            if (!(await lstat(parent)).isDirectory())
+                continue;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                continue;
+            throw error;
+        }
+        for (const entry of await readdir(parent))
+            if (entry.startsWith('mpfrontend-') && !catalog.has(entry))
+                throw new SkillsError('RESERVED_SKILL_NAME:' + base + '/' + entry, 3);
+    }
+}
+export async function installSkills(options) {
+    const profile = options.profile ?? 'base', agent = options.agent ?? 'both';
+    if (!['base', 'design'].includes(profile) || !['codex', 'claude', 'both'].includes(agent))
+        throw new SkillsError('INVALID_SKILL_PROFILE_OR_AGENT', 2);
+    const root = await realpath(resolve(options.directory)), previousLock = await content(root, lockPath), lock = parseLock(previousLock);
+    if (await content(root, mutexPath) !== undefined)
+        throw new SkillsError('SKILLS_INSTALL_BUSY');
+    if (options.update && !lock)
+        throw new SkillsError('SKILLS_NOT_INSTALLED', 2);
+    // Updates preserve the installed selection unless the caller explicitly changes it.
+    const selectedProfile = options.profile ?? lock?.profile ?? profile;
+    const agents = options.agent ? (agent === 'both' ? ['codex', 'claude'] : [agent]) : lock?.agents ?? ['codex', 'claude'];
+    const catalog = skillCatalog(), selected = catalog.skills.filter(s => selectedProfile === 'design' || s.profile === 'base');
+    const desired = new Map(), before = new Map();
+    const files = { ...lock?.files };
+    for (const skill of selected.filter(s => s.available)) {
+        const source = await readFile(new URL('../skills/' + skill.name + '/SKILL.md', import.meta.url), 'utf8');
+        for (const target of agents) {
+            const path = (target === 'codex' ? '.agents' : '.claude') + '/skills/' + skill.name + '/SKILL.md';
+            const old = await content(root, path);
+            if (old !== undefined && (!lock?.files[path] || hash(old) !== lock.files[path]))
+                throw new SkillsError('MODIFIED_OR_UNOWNED_SKILL:' + path);
+            before.set(path, old);
+            files[path] = hash(source);
+            if (old !== source)
+                desired.set(path, source);
+        }
+    }
+    await refuseReservedNames(root);
+    const next = { generator: 'MPFrontendSkills', schemaVersion: 1, version: SKILLS_VERSION, cliVersion: SKILLS_CLI_VERSION, profile: selectedProfile, agents, files };
+    const encoded = JSON.stringify(next, null, 2) + '\n';
+    before.set(lockPath, previousLock);
+    if (previousLock !== encoded)
+        desired.set(lockPath, encoded);
+    const changes = [...desired].map(([path, text]) => ({ path, beforeHash: before.get(path) === undefined ? null : hash(before.get(path)), afterHash: hash(text) }));
+    if (!options.dryRun) {
+        const staged = new Map(), replaced = [];
+        const owner = randomUUID();
+        let acquired = false;
+        try {
+            await mkdir(join(root, '.mpfrontend'), { recursive: true });
+            await content(root, mutexPath);
+            try {
+                await writeFile(join(root, mutexPath), owner, { flag: 'wx' });
+                acquired = true;
+            }
+            catch (error) {
+                if (error.code === 'EEXIST')
+                    throw new SkillsError('SKILLS_INSTALL_BUSY');
+                throw error;
+            }
+            for (const [path, text] of desired) {
+                if (await content(root, path) !== before.get(path))
+                    throw new SkillsError('CONCURRENT_SKILL_EDIT:' + path);
+                await mkdir(dirname(join(root, path)), { recursive: true });
+                const stage = join(dirname(join(root, path)), '.mpfrontend-' + randomUUID());
+                await writeFile(stage, text, { flag: 'wx' });
+                staged.set(path, stage);
+            }
+            // Lock is written last. No AGENTS.md, CLAUDE.md or unrelated skill is altered.
+            for (const [path, stage] of staged) {
+                const current = await content(root, path);
+                if (current !== before.get(path))
+                    throw new SkillsError('CONCURRENT_SKILL_EDIT:' + path);
+                await rename(stage, join(root, path));
+                staged.delete(path);
+                replaced.push(path);
+            }
+        }
+        catch (error) {
+            const conflicts = [];
+            for (const path of replaced.reverse()) {
+                // A second agent's edit is never overwritten by rollback, even on a failed install.
+                if (await content(root, path) !== desired.get(path)) {
+                    conflicts.push(path);
+                    continue;
+                }
+                const old = before.get(path);
+                if (old === undefined)
+                    await unlink(join(root, path));
+                else
+                    await writeFile(join(root, path), old);
+            }
+            if (conflicts.length)
+                throw new SkillsError('SKILL_ROLLBACK_CONFLICT:' + conflicts.join(','));
+            throw error;
+        }
+        finally {
+            for (const path of staged.values())
+                await unlink(path).catch(() => undefined);
+            if (acquired && await content(root, mutexPath) === owner)
+                await unlink(join(root, mutexPath));
+        }
+    }
+    return { ok: true, version: SKILLS_VERSION, profile: selectedProfile, agents, dryRun: options.dryRun ?? false, changes,
+        installed: selected.filter(s => s.available).map(s => s.name), unavailable: selected.filter(s => !s.available) };
+}
+export async function checkSkills(directory) {
+    const root = await realpath(resolve(directory));
+    if (await content(root, mutexPath) !== undefined)
+        throw new SkillsError('SKILLS_INSTALL_BUSY');
+    const lock = parseLock(await content(root, lockPath));
+    if (!lock)
+        throw new SkillsError('SKILLS_NOT_INSTALLED', 2);
+    if (lock.version !== SKILLS_VERSION || lock.cliVersion !== SKILLS_CLI_VERSION)
+        throw new SkillsError('SKILLS_VERSION_MISMATCH', 3);
+    await refuseReservedNames(root);
+    const catalog = skillCatalog();
+    let checked = 0;
+    for (const skill of catalog.skills.filter(s => s.available && (lock.profile === 'design' || s.profile === 'base')))
+        for (const agent of lock.agents) {
+            const path = (agent === 'codex' ? '.agents' : '.claude') + '/skills/' + skill.name + '/SKILL.md';
+            if (!lock.files[path])
+                throw new SkillsError('INCOMPLETE_SKILLS_LOCK:' + path, 3);
+        }
+    for (const [path, digest] of Object.entries(lock.files)) {
+        const old = await content(root, path);
+        if (old === undefined || hash(old) !== digest)
+            throw new SkillsError('INSTALLED_SKILL_DRIFT:' + path, 3);
+        const name = path.split('/')[2], skill = catalog.skills.find(s => s.name === name);
+        if (!skill?.available)
+            throw new SkillsError('UNAVAILABLE_INSTALLED_SKILL:' + name, 3);
+        const source = await readFile(new URL('../skills/' + name + '/SKILL.md', import.meta.url), 'utf8');
+        if (hash(source) !== digest)
+            throw new SkillsError('SKILLS_SOURCE_DRIFT:' + name, 3);
+        checked++;
+    }
+    if (!checked)
+        throw new SkillsError('EMPTY_SKILLS_LOCK', 3);
+    return { ok: true, version: SKILLS_VERSION, checked, agents: lock.agents };
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpfrontend/ai-skills",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -14,6 +14,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "import": "./dist/internal.js"
     }
   },
   "files": [

package/skills/mpfrontend-apply-access/SKILL.md

@@ -5,7 +5,7 @@ description: Apply an approved capability and field/action visibility matrix to
 
 # Apply approved access decisions
 
-Requires the reviewed MP Frontend CLI `0.1.0` cohort, `@mpfrontend/access-core` and
+Requires the reviewed MP Frontend CLI `1.0.0` cohort, `@mpfrontend/access-core` and
 `@mpfrontend/access-react`. Read the approved capability catalog, persona/tenant matrix and consumer
 instructions. Do not create roles, resources, permissions or grants and do not infer authority from a sample
 identity.
@@ -24,7 +24,8 @@ snapshot in a server component with `createAccessLoader` of `@mpfrontend/access-
 endpoint through the BFF, the request's context reference, `manifestKeys`, an explicit `timeoutMs`) and pass
 `clientSnapshot(result, pageKeys(manifest, page))` to an `AccessProvider`. Present with `AccessGuard`,
 `AccessLink`, `useCapability`, `useFieldState`, `useNavigation` and the `access` property of `ResourceTable` and
-`ResourceForm`. Denied is hidden by default; use a guard's `fallback` or `whenDenied="disabled"` only where the
+`ResourceForm`; a `ResourceForm` with `access` also needs `original`, the values the person started from (an empty
+object for a new record), which its type requires. Denied is hidden by default; use a guard's `fallback` or `whenDenied="disabled"` only where the
 approved UX says so, never by guessing.
 
 Wrap protected asynchronous reads in `AuthorityFence`: inside a provider, capture with `useAccessCapture()` before

package/skills/mpfrontend-implement-feature/SKILL.md

@@ -5,7 +5,7 @@ description: Implement one approved MP Frontend feature slice across an existing
 
 # Implement an approved feature slice
 
-Requires the reviewed MP Frontend CLI `0.1.0` cohort. Read repository instructions, the approved
+Requires the reviewed MP Frontend CLI `1.0.0` cohort. Read repository instructions, the approved
 story and acceptance criteria before editing. Stop when the API contract, permission, tenant rule,
 business transition or DLS behavior is absent or contradictory; never invent it to complete a screen.
 

package/skills/mpfrontend-import-design-system/SKILL.md

@@ -5,7 +5,7 @@ description: Import a supplied normalized local DLS export as an immutable MP Fr
 
 # Import a declared design export
 
-Requires MP Frontend CLI 0.1.0 or the reviewed compatible cohort. Read the consumer instructions,
+Requires MP Frontend CLI 1.0.0 or the reviewed compatible cohort. Read the consumer instructions,
 installed CLI `DESIGN-SYNC.md`, approved source and its distribution limits. Check the actual
 `mpfrontend --version`. The CLI consumes a finite normalized export; it does not capture Figma.
 Prefer supplied local evidence. If another authorized read connector is available, follow that

package/skills/mpfrontend-integrate-auth/SKILL.md

@@ -5,7 +5,7 @@ description: Integrate an existing consumer with the MP Frontend server-side OID
 
 # Integrate server-side authentication
 
-Requires the reviewed MP Frontend CLI `0.1.0` cohort and `@mpfrontend/security-bff`. Read the
+Requires the reviewed MP Frontend CLI `1.0.0` cohort and `@mpfrontend/security-bff`. Read the
 consumer instructions and obtain approved issuer, client, callback/logout URLs, audiences, route policy,
 cookie domain and supported UI locales. Missing provider metadata or secret ownership is a prerequisite,
 not permission to create identity data.

package/skills/mpfrontend-integrate-openapi/SKILL.md

@@ -5,7 +5,7 @@ description: Integrate approved local OpenAPI 3.1 responses or explicitly select
 
 # Integrate an explicit API contract
 
-Requires MP Frontend CLI `0.1.0`. Read the consumer instructions and the named API owner's
+Requires MP Frontend CLI `1.0.0`. Read the consumer instructions and the named API owner's
 contract before edits. An implementation request permits scoped integration; a review alone does not.
 
 Establish the public presentation boundary: browser paths, server operation bindings, auth/roles,

package/skills/mpfrontend-integrate-realtime/SKILL.md

@@ -5,7 +5,7 @@ description: Integrate an approved realtime event contract with MP Frontend tick
 
 # Integrate an approved realtime stream
 
-Requires the reviewed MP Frontend CLI `0.1.0` cohort and `@mpfrontend/realtime-core`. Read the
+Requires the reviewed MP Frontend CLI `1.0.0` cohort and `@mpfrontend/realtime-core`. Read the
 consumer instructions plus the approved event/topic schema, ordering/idempotency rules, admission
 policy and snapshot endpoint. Stop rather than inventing event names, replay guarantees or recovery
 semantics.

package/skills/mpfrontend-prepare-release/SKILL.md

@@ -31,9 +31,10 @@ package declare, with every framework pin (the app template, the Nx plugin's coh
 `node tools/distribution/release.mjs guard --version <v> --ref <ref>` and its `self-test` prove this offline. A version
 the registry already holds is never built again: a corrected build takes the next version, and a bad version is
 deprecated, never unpublished. Check the API against the policy of README "Versioning" with `pnpm check` (the
-`api-check` of every package's `api-report.json`) and, once a version is published, `node
-tools/distribution/api-report.mjs registry`; while the major version is 0 a break needs a new minor version and
-release notes that say how to move. Run `pnpm exec nx run distribution:registry-install` for the scope binding and
+`api-check` of every package's `api-report.json` and of the published archives that
+`tools/distribution/api-baseline.json` names); from 1.0.0 a break needs a new major version and release notes that
+say how to move. After a release, move the baseline to it in a commit of its own with `node
+tools/distribution/api-report.mjs baseline --record <release.json>`. Run `pnpm exec nx run distribution:registry-install` for the scope binding and
 the exact pins against throw-away local registries. The owner then runs the release workflow
 (`.github/workflows/release.yml`) without `publish` as a rehearsal, and with it only on main, as
 docs/RELEASE-GUIDE.md describes.

package/skills/mpfrontend-reconcile-design-components/SKILL.md

@@ -5,7 +5,7 @@ description: Reconcile declared added, changed or removed DLS components with MP
 
 # Reconcile authored component behavior
 
-Requires the reviewed CLI 0.1.0 cohort, an attached design source and a normalized candidate with explicit interaction evidence.
+Requires the reviewed CLI 1.0.0 cohort, an attached design source and a normalized candidate with explicit interaction evidence.
 Read consumer instructions, installed CLI `DESIGN-SYNC.md`, approved source, adapter bindings and
 the actual public UI types. Use stable IDs for component identity; display renames do not justify
 creating duplicates. Core currently exposes six finite components, not the whole supplied DLS.

package/skills/mpfrontend-review-design-drift/SKILL.md

@@ -5,7 +5,7 @@ description: Review an MP Frontend declared design candidate or accepted baselin
 
 # Review declared design drift
 
-Requires the reviewed CLI 0.1.0 cohort. Read consumer instructions, installed CLI `DESIGN-SYNC.md`,
+Requires the reviewed CLI 1.0.0 cohort. Read consumer instructions, installed CLI `DESIGN-SYNC.md`,
 accepted source/binding and any supplied candidate's provenance. A review request is read-only:
 do not import, persist a plan, apply tokens, edit Figma, run a live write or accept a baseline.
 If the candidate is not imported, an explicit import implementation request is a prerequisite.

package/skills/mpfrontend-scaffold-app/SKILL.md

@@ -5,7 +5,7 @@ description: Create an independent MP Frontend Next.js app with the installed CL
 
 # Scaffold an app
 
-Requires MP Frontend CLI `0.1.0` and the compatible packaged Nx plugin. Read the consumer's
+Requires MP Frontend CLI `1.0.0` and the compatible packaged Nx plugin. Read the consumer's
 repository instructions before changing files; this skill grants no release or external-write authority.
 
 Obtain the app name, new destination and an approved local OpenAPI projection. Do not choose a

package/skills/mpfrontend-sync-design-tokens/SKILL.md

@@ -5,7 +5,7 @@ description: Plan and apply reviewed light/dark/system token updates from an MP
 
 # Synchronize declared consumer tokens
 
-Requires the reviewed CLI 0.1.0 cohort, an attached design source and a supplied/imported candidate. Read consumer instructions,
+Requires the reviewed CLI 1.0.0 cohort, an attached design source and a supplied/imported candidate. Read consumer instructions,
 installed CLI `DESIGN-SYNC.md`, source provenance and the current accepted binding. The installed
 import procedure describes acquisition; no Figma write or automatic watcher is part of this workflow.
 Run `design status` first and stop on pending, disabled or drifted source state; do not bypass source

package/skills/mpfrontend-upgrade-project/SKILL.md

@@ -14,8 +14,10 @@ Every `@mpfrontend` package carries one cohort version; pin all of them, and the
 workspace configuration, at that exact version, never a range. Keep the scope bound to the public registry in
 `.npmrc` (`@mpfrontend:registry=https://registry.npmjs.org/`), so that no other registry can serve it. After the
 install, compare the lockfile's integrity of each package with the release record (`docs/releases/<version>.md`)
-and run `npm audit signatures` for the registry signatures and provenance. Read the release notes first: while the
-major version is 0 a minor version may break, and its notes say how to move; a patch never breaks. Offline, install
+and run `npm audit signatures` for the registry signatures and provenance. Read the release notes first: from 1.0.0
+only a major version breaks, and its notes say how to move; a minor version only adds and a patch never breaks.
+Before 1.0.0, while the major version was 0, a minor version could break. Exports of an entry named `internal` are
+outside the compatibility guarantee: never import one in a product. Offline, install
 the release's archives through pnpm overrides and lock the SHA-256 of the release record.
 
 Before mutation, record the current working-tree diff and runnable gates. Use `mpfrontend skills update

package/skills/mpfrontend-verify-frontend/SKILL.md

@@ -5,7 +5,7 @@ description: Verify a bounded MP Frontend consumer change using existing Nx and
 
 # Verify a bounded change
 
-Requires MP Frontend CLI `0.1.0`. Read the consumer's instructions, changed-file scope and
+Requires MP Frontend CLI `1.0.0`. Read the consumer's instructions, changed-file scope and
 acceptance criteria. A review/diagnosis is read-only apart from normal diagnostic build/test artifacts;
 fixes, restarts, business writes and release actions require the corresponding user request.