@rpamis/comet 0.3.9 → 0.4.0-beta.1

package/dist/domains/skill/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../../domains/skill/preferences.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEtD,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,QAAQ,CAAC;AACxD,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,CAAC;AAChD,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,CAAC;AAClD,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,MAAM,CAAC;AACjD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,oBAAoB,CAAC;IAChC,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,uBAAuB,CAAC;CACnC;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,kBAAkB,GAAG,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,MAAM,WAAW,iCAAiC;IAChD,WAAW,EAAE,0BAA0B,CAAC;IACxC,QAAQ,EAAE,sBAAsB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,uBAAwB,SAAQ,iCAAiC;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AA8DD,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,EACd,IAAI,SAAkC,GACrC,iCAAiC,CA2EnC;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,0BAA0B,GACtC,oBAAoB,EAAE,CASxB;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAgBzC"}

package/dist/domains/skill/preferences.js

@@ -0,0 +1,118 @@
+import { createHash } from 'crypto';
+import { promises as fs } from 'fs';
+import path from 'path';
+import { parse } from 'yaml';
+const DEFAULT_POLICIES = {
+    missing: 'ask',
+    ambiguous: 'ask',
+    deviation: 'explain',
+    scripts: 'disclose',
+    hooks: 'disclose',
+};
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function assertStringArray(value, file, field) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value))
+        throw new Error(`${file}: ${field} must be a string array`);
+    return value.map((item, index) => {
+        if (typeof item !== 'string' || item.trim().length === 0) {
+            throw new Error(`${file}: ${field}[${index}] must be a non-empty string`);
+        }
+        return item.trim();
+    });
+}
+function dedupeSkills(values, code, label, warnings) {
+    const seen = new Set();
+    const result = [];
+    for (const value of values) {
+        if (seen.has(value)) {
+            warnings.push({
+                code,
+                message: `Duplicate ${label} Skill ignored: ${value}`,
+                skill: value,
+            });
+            continue;
+        }
+        seen.add(value);
+        result.push(value);
+    }
+    return result;
+}
+function enumValue(value, file, field, allowed, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== 'string' || !allowed.includes(value)) {
+        throw new Error(`${file}: ${field} must be one of ${allowed.join(', ')}`);
+    }
+    return value;
+}
+export function normalizeSkillPreferencesDocument(value, file = '.comet/skill-preferences.yaml') {
+    if (!isRecord(value))
+        throw new Error(`${file}: document must be an object`);
+    if (value.version !== 1)
+        throw new Error(`${file}: version must be 1`);
+    const warnings = [];
+    for (const key of Object.keys(value)) {
+        if (!['version', 'mode', 'prefer', 'require', 'policies'].includes(key)) {
+            warnings.push({
+                code: 'unknown-field',
+                message: `Unknown top-level field ignored: ${key}`,
+                field: key,
+            });
+        }
+    }
+    const mode = enumValue(value.mode, file, 'mode', ['advisory', 'strict'], 'advisory');
+    if (value.policies !== undefined && !isRecord(value.policies)) {
+        throw new Error(`${file}: policies must be an object`);
+    }
+    const policiesRecord = value.policies ?? {};
+    const policies = {
+        missing: enumValue(policiesRecord.missing, file, 'policies.missing', ['ask', 'fail'], DEFAULT_POLICIES.missing),
+        ambiguous: enumValue(policiesRecord.ambiguous, file, 'policies.ambiguous', ['ask', 'fail'], DEFAULT_POLICIES.ambiguous),
+        deviation: enumValue(policiesRecord.deviation, file, 'policies.deviation', ['explain', 'fail'], DEFAULT_POLICIES.deviation),
+        scripts: enumValue(policiesRecord.scripts, file, 'policies.scripts', ['allow', 'disclose', 'deny'], DEFAULT_POLICIES.scripts),
+        hooks: enumValue(policiesRecord.hooks, file, 'policies.hooks', ['allow', 'disclose', 'deny'], DEFAULT_POLICIES.hooks),
+    };
+    const prefer = dedupeSkills(assertStringArray(value.prefer, file, 'prefer'), 'duplicate-prefer', 'prefer', warnings);
+    const required = dedupeSkills(assertStringArray(value.require, file, 'require'), 'duplicate-require', 'require', warnings);
+    return {
+        preferences: { version: 1, mode, prefer, require: required, policies },
+        warnings,
+    };
+}
+export function skillPreferenceEntries(preferences) {
+    const seen = new Set();
+    const entries = [];
+    for (const query of [...preferences.prefer, ...preferences.require]) {
+        if (seen.has(query))
+            continue;
+        seen.add(query);
+        entries.push({ query, preferenceIndex: entries.length });
+    }
+    return entries;
+}
+export function skillPreferencesPath(projectRoot) {
+    return path.resolve(projectRoot, '.comet', 'skill-preferences.yaml');
+}
+export async function readProjectSkillPreferences(projectRoot) {
+    const file = skillPreferencesPath(projectRoot);
+    let source;
+    try {
+        source = await fs.readFile(file, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+    const parsed = parse(source);
+    return {
+        path: file,
+        hash: createHash('sha256').update(source).digest('hex'),
+        ...normalizeSkillPreferencesDocument(parsed, file),
+    };
+}
+//# sourceMappingURL=preferences.js.map

package/dist/domains/skill/preferences.js.map

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

package/dist/domains/skill/snapshot.d.ts

@@ -0,0 +1,8 @@
+import type { SkillPackage } from './types.js';
+export declare function hashSkillPackage(pkg: SkillPackage): Promise<string>;
+export declare function createSkillSnapshot(pkg: SkillPackage, changeDir: string): Promise<{
+    hash: string;
+    snapshotDir: string;
+}>;
+export declare function readSkillSnapshot(changeDir: string, hash: string): Promise<SkillPackage>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/domains/skill/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../domains/skill/snapshot.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA0G/C,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAEzE;AA8BD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAuChD;AAED,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA4B9F"}

package/dist/domains/skill/snapshot.js

@@ -0,0 +1,184 @@
+import { createHash, randomUUID } from 'crypto';
+import { promises as fs } from 'fs';
+import path from 'path';
+import { loadSkillPackageDocument } from './load.js';
+import { validateSkillPackage } from './validate.js';
+function stable(value) {
+    if (Array.isArray(value))
+        return value.map(stable);
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, item]) => [key, stable(item)]));
+    }
+    return value;
+}
+function packageDocument(pkg) {
+    return stable({
+        ...(pkg.packageKind === 'runtime' ? { packageKind: 'runtime' } : {}),
+        definition: pkg.definition,
+        guardrails: pkg.guardrails,
+        evals: pkg.evals,
+    });
+}
+function normalizedRelativePath(source) {
+    return path.posix.normalize(source.replaceAll('\\', '/'));
+}
+function assertInside(parent, target, label) {
+    const relative = path.relative(parent, target);
+    if (relative === '' || (!path.isAbsolute(relative) && !relative.startsWith(`..${path.sep}`))) {
+        return;
+    }
+    throw new Error(`${label} resolves outside the Skill package`);
+}
+async function readPackageFile(root, relativePath, label) {
+    const normalized = normalizedRelativePath(relativePath);
+    if (path.posix.isAbsolute(normalized) || normalized === '..' || normalized.startsWith('../')) {
+        throw new Error(`${label} resolves outside the Skill package`);
+    }
+    const target = path.resolve(root, ...normalized.split('/'));
+    assertInside(root, target, label);
+    let realTarget;
+    try {
+        realTarget = await fs.realpath(target);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`${label} does not exist: ${relativePath}`, { cause: error });
+        }
+        throw error;
+    }
+    assertInside(root, realTarget, label);
+    if (!(await fs.stat(realTarget)).isFile()) {
+        throw new Error(`${label} is not a file: ${relativePath}`);
+    }
+    return { path: normalized, content: await fs.readFile(realTarget) };
+}
+async function snapshotFiles(pkg) {
+    const root = await fs.realpath(pkg.root);
+    const files = pkg.packageKind === 'runtime' ? [] : [await readPackageFile(root, 'SKILL.md', 'SKILL.md')];
+    for (const tool of pkg.definition.tools) {
+        if (tool.kind !== 'script')
+            continue;
+        files.push(await readPackageFile(root, tool.source, `Script tool ${tool.id}`));
+    }
+    return files.sort((left, right) => left.path.localeCompare(right.path));
+}
+function hashSnapshot(document, files) {
+    const fileDigests = files.map((file) => ({
+        path: file.path,
+        sha256: createHash('sha256').update(file.content).digest('hex'),
+    }));
+    return createHash('sha256')
+        .update(JSON.stringify(stable({ package: document, files: fileDigests })))
+        .digest('hex');
+}
+function packageJson(document) {
+    return JSON.stringify(document, null, 2) + '\n';
+}
+async function snapshotMaterial(pkg) {
+    const document = packageDocument(pkg);
+    const files = await snapshotFiles(pkg);
+    return { document, files, hash: hashSnapshot(document, files) };
+}
+export async function hashSkillPackage(pkg) {
+    return (await snapshotMaterial(pkg)).hash;
+}
+async function pathExists(target) {
+    try {
+        await fs.access(target);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+async function verifyPublishedSnapshot(snapshotDir, material) {
+    try {
+        const storedHash = (await fs.readFile(path.join(snapshotDir, 'sha256'), 'utf8')).trim();
+        if (storedHash !== material.hash)
+            throw new Error('hash mismatch');
+        const storedPackage = await fs.readFile(path.join(snapshotDir, 'package.json'), 'utf8');
+        if (storedPackage !== packageJson(material.document))
+            throw new Error('package mismatch');
+        for (const file of material.files) {
+            const stored = await fs.readFile(path.join(snapshotDir, ...file.path.split('/')));
+            if (!stored.equals(file.content))
+                throw new Error(`file mismatch: ${file.path}`);
+        }
+    }
+    catch (error) {
+        throw new Error(`Existing Skill snapshot is invalid: ${material.hash}`, { cause: error });
+    }
+}
+export async function createSkillSnapshot(pkg, changeDir) {
+    const material = await snapshotMaterial(pkg);
+    const snapshotsRoot = path.resolve(changeDir, '.comet', 'skill-snapshots');
+    const snapshotDir = path.join(snapshotsRoot, material.hash);
+    await fs.mkdir(snapshotsRoot, { recursive: true });
+    if (await pathExists(snapshotDir)) {
+        await verifyPublishedSnapshot(snapshotDir, material);
+        return { hash: material.hash, snapshotDir };
+    }
+    const temporaryDir = path.join(snapshotsRoot, `.tmp-${randomUUID()}`);
+    assertInside(snapshotsRoot, temporaryDir, 'Temporary snapshot');
+    assertInside(snapshotsRoot, snapshotDir, 'Published snapshot');
+    try {
+        await fs.mkdir(temporaryDir);
+        for (const file of material.files) {
+            const destination = path.join(temporaryDir, ...file.path.split('/'));
+            assertInside(temporaryDir, destination, `Snapshot file ${file.path}`);
+            await fs.mkdir(path.dirname(destination), { recursive: true });
+            await fs.writeFile(destination, file.content);
+        }
+        await fs.writeFile(path.join(temporaryDir, 'package.json'), packageJson(material.document));
+        await fs.writeFile(path.join(temporaryDir, 'sha256'), material.hash + '\n');
+        await fs.rename(temporaryDir, snapshotDir);
+    }
+    catch (error) {
+        if (await pathExists(snapshotDir)) {
+            try {
+                await verifyPublishedSnapshot(snapshotDir, material);
+            }
+            finally {
+                await fs.rm(temporaryDir, { recursive: true, force: true });
+            }
+            return { hash: material.hash, snapshotDir };
+        }
+        await fs.rm(temporaryDir, { recursive: true, force: true });
+        throw error;
+    }
+    return { hash: material.hash, snapshotDir };
+}
+export async function readSkillSnapshot(changeDir, hash) {
+    if (!/^[a-f0-9]{64}$/u.test(hash)) {
+        throw new Error(`Invalid Skill snapshot hash: ${hash}`);
+    }
+    const snapshotsRoot = path.resolve(changeDir, '.comet', 'skill-snapshots');
+    const snapshotDir = path.join(snapshotsRoot, hash);
+    assertInside(snapshotsRoot, snapshotDir, 'Skill snapshot');
+    try {
+        const storedHash = (await fs.readFile(path.join(snapshotDir, 'sha256'), 'utf8')).trim();
+        if (storedHash !== hash) {
+            throw new Error(`stored hash is ${storedHash || '(empty)'}`);
+        }
+        const packagePath = path.join(snapshotDir, 'package.json');
+        const document = JSON.parse(await fs.readFile(packagePath, 'utf8'));
+        const pkg = loadSkillPackageDocument(document, snapshotDir, packagePath);
+        const errors = validateSkillPackage(pkg);
+        if (errors.length > 0) {
+            throw new Error(errors.map((error) => `  - ${error}`).join('\n'));
+        }
+        const calculated = await hashSkillPackage(pkg);
+        if (calculated !== hash) {
+            throw new Error(`calculated hash is ${calculated}`);
+        }
+        return pkg;
+    }
+    catch (error) {
+        throw new Error(`Skill snapshot is invalid or missing: ${hash}`, { cause: error });
+    }
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/domains/skill/snapshot.js.map

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

package/dist/domains/skill/types.d.ts

@@ -0,0 +1,85 @@
+export type OrchestrationMode = 'deterministic' | 'adaptive';
+export type ActionType = 'invoke_skill' | 'call_tool' | 'handoff' | 'ask_user' | 'checkpoint';
+export type SkillPackageKind = 'skill' | 'runtime';
+export interface NamedContract {
+    name: string;
+    description: string;
+    required?: boolean;
+}
+export interface SkillReference {
+    id: string;
+    source?: string;
+    version?: string;
+}
+export interface AgentDefinition {
+    id: string;
+    role: string;
+    instructions?: string;
+}
+export interface ToolDefinition {
+    id: string;
+    kind: 'function' | 'mcp' | 'script' | 'agent';
+    source: string;
+    sideEffect: 'none' | 'read' | 'write' | 'external';
+    requiresConfirmation?: boolean;
+}
+export interface StepAction {
+    type: ActionType;
+    ref?: string;
+    prompt?: string;
+    question?: string;
+    options?: string[];
+}
+export interface SkillStep {
+    id: string;
+    action: StepAction;
+    next?: string;
+    completionEvals?: string[];
+}
+export interface SkillDefinition {
+    apiVersion: 'comet/v1alpha1';
+    kind: 'Skill';
+    metadata: {
+        name: string;
+        version: string;
+        description: string;
+    };
+    goal: {
+        statement: string;
+        inputs: NamedContract[];
+        outputs: NamedContract[];
+        success: string[];
+    };
+    orchestration: {
+        mode: OrchestrationMode;
+        entry?: string;
+        steps?: SkillStep[];
+    };
+    skills: SkillReference[];
+    agents: AgentDefinition[];
+    tools: ToolDefinition[];
+}
+export interface GuardrailDefinition {
+    allowedSkills: string[];
+    allowedAgents: string[];
+    allowedTools: string[];
+    maxIterations: number;
+    maxRetriesPerAction: number;
+    confirmationRequiredFor: string[];
+}
+export interface RuntimeEvalDefinition {
+    id: string;
+    scope: 'progress' | 'step' | 'completion';
+    type: 'artifact_exists' | 'state_equals';
+    artifact?: string;
+    field?: string;
+    equals?: string;
+}
+export interface SkillPackage {
+    root: string;
+    packageKind?: SkillPackageKind;
+    definition: SkillDefinition;
+    guardrails: GuardrailDefinition;
+    evals: RuntimeEvalDefinition[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/domains/skill/types.d.ts.map

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

package/dist/domains/skill/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/{core → domains/skill}/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../domains/skill/types.ts"],"names":[],"mappings":""}

package/dist/{core → domains/skill}/uninstall.d.ts

@@ -1,28 +1,12 @@
-import { type Platform } from './platforms.js';
-import type { InstallScope } from './types.js';
+import { type Platform } from '../../platform/install/platforms.js';
+import type { InstallScope } from '../../platform/install/types.js';
 interface RemovalResult {
     removed: number;
     failed: number;
 }
-/**
- * Remove Comet skill files for a specific platform.
- * Reads the manifest to determine which skill paths to remove.
- */
 declare function removeCometSkillsForPlatform(baseDir: string, platform: Platform, scope?: InstallScope): Promise<RemovalResult>;
-/**
- * Remove Comet rule files for a specific platform.
- * Reuses computeRuleDestPath for consistent path computation.
- */
 declare function removeCometRulesForPlatform(baseDir: string, platform: Platform, scope?: InstallScope): Promise<RemovalResult>;
-/**
- * Remove Comet hooks for platforms that support them.
- * Preserves non-Comet hooks in configuration files.
- */
 declare function removeCometHooksForPlatform(baseDir: string, platform: Platform, scope?: InstallScope): Promise<RemovalResult>;
-/**
- * Remove Comet working directories from a project.
- * Only applies to project scope.
- */
 declare function removeWorkingDirs(projectPath: string): Promise<RemovalResult>;
 export { removeCometSkillsForPlatform, removeCometRulesForPlatform, removeCometHooksForPlatform, removeWorkingDirs, };
 //# sourceMappingURL=uninstall.d.ts.map

package/dist/domains/skill/uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../domains/skill/uninstall.ts"],"names":[],"mappings":"AAUA,OAAO,EAAwB,KAAK,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAC1F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAQpE,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,iBAAe,4BAA4B,CACzC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,KAAK,GAAE,YAAwB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAwExB;AAED,iBAAe,2BAA2B,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,KAAK,GAAE,YAAwB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAuCxB;AAED,iBAAe,2BAA2B,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,KAAK,GAAE,YAAwB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAqCxB;AAsQD,iBAAe,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA6B5E;AAED,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,2BAA2B,EAC3B,iBAAiB,GAClB,CAAC"}