anantham-v2 2.0.0-alpha.1

package/dist/domain/skill.d.ts

@@ -0,0 +1,465 @@
+/**
+ * Anantham V2 — Skill Domain Contracts
+ *
+ * Defines authoritative domain models, types, and runtime Zod schemas for
+ * Skill manifests, frontmatter, procedures, metadata indices, test fixtures,
+ * execution provenance records, and lifecycle states.
+ */
+import { z } from "zod";
+export declare const SkillLifecycleStateSchema: z.ZodEnum<["discovered", "validated", "installed", "enabled", "disabled", "loading", "loaded", "failed"]>;
+export type SkillLifecycleState = z.infer<typeof SkillLifecycleStateSchema>;
+export declare const SkillTrustStateSchema: z.ZodEnum<["unknown", "reviewed", "trusted", "blocked"]>;
+export type SkillTrustState = z.infer<typeof SkillTrustStateSchema>;
+export declare const SkillFrontmatterSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    version: z.ZodString;
+    tools: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    mcp: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    skills: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    capabilities: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    runtime: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    publisher: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    version: string;
+    mcp: string[];
+    tags: string[];
+    description: string;
+    tools: string[];
+    capabilities: string[];
+    runtime: string;
+    publisher: string;
+    skills: string[];
+}, {
+    name: string;
+    version: string;
+    description: string;
+    mcp?: string[] | undefined;
+    tags?: string[] | undefined;
+    tools?: string[] | undefined;
+    capabilities?: string[] | undefined;
+    runtime?: string | undefined;
+    publisher?: string | undefined;
+    skills?: string[] | undefined;
+}>;
+export type SkillFrontmatter = z.infer<typeof SkillFrontmatterSchema>;
+export declare const SkillMetadataSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    version: z.ZodString;
+    tools: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    mcp: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    skills: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    capabilities: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    runtime: z.ZodDefault<z.ZodString>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    publisher: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    version: string;
+    id: string;
+    mcp: string[];
+    tags: string[];
+    description: string;
+    tools: string[];
+    capabilities: string[];
+    runtime: string;
+    publisher: string;
+    skills: string[];
+}, {
+    name: string;
+    version: string;
+    id: string;
+    description: string;
+    mcp?: string[] | undefined;
+    tags?: string[] | undefined;
+    tools?: string[] | undefined;
+    capabilities?: string[] | undefined;
+    runtime?: string | undefined;
+    publisher?: string | undefined;
+    skills?: string[] | undefined;
+}>;
+export type SkillMetadata = z.infer<typeof SkillMetadataSchema>;
+export declare const SkillProcedureSchema: z.ZodObject<{
+    preconditions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    steps: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    successCriteria: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    rawMarkdown: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    preconditions: string[];
+    steps: string[];
+    successCriteria: string[];
+    rawMarkdown: string;
+}, {
+    preconditions?: string[] | undefined;
+    steps?: string[] | undefined;
+    successCriteria?: string[] | undefined;
+    rawMarkdown?: string | undefined;
+}>;
+export type SkillProcedure = z.infer<typeof SkillProcedureSchema>;
+export declare const SkillManifestSchema: z.ZodObject<{
+    metadata: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        version: z.ZodString;
+        tools: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        mcp: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        skills: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        capabilities: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        runtime: z.ZodDefault<z.ZodString>;
+        tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        publisher: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+        id: string;
+        mcp: string[];
+        tags: string[];
+        description: string;
+        tools: string[];
+        capabilities: string[];
+        runtime: string;
+        publisher: string;
+        skills: string[];
+    }, {
+        name: string;
+        version: string;
+        id: string;
+        description: string;
+        mcp?: string[] | undefined;
+        tags?: string[] | undefined;
+        tools?: string[] | undefined;
+        capabilities?: string[] | undefined;
+        runtime?: string | undefined;
+        publisher?: string | undefined;
+        skills?: string[] | undefined;
+    }>;
+    procedure: z.ZodObject<{
+        preconditions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        steps: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        successCriteria: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        rawMarkdown: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        preconditions: string[];
+        steps: string[];
+        successCriteria: string[];
+        rawMarkdown: string;
+    }, {
+        preconditions?: string[] | undefined;
+        steps?: string[] | undefined;
+        successCriteria?: string[] | undefined;
+        rawMarkdown?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    metadata: {
+        name: string;
+        version: string;
+        id: string;
+        mcp: string[];
+        tags: string[];
+        description: string;
+        tools: string[];
+        capabilities: string[];
+        runtime: string;
+        publisher: string;
+        skills: string[];
+    };
+    procedure: {
+        preconditions: string[];
+        steps: string[];
+        successCriteria: string[];
+        rawMarkdown: string;
+    };
+}, {
+    metadata: {
+        name: string;
+        version: string;
+        id: string;
+        description: string;
+        mcp?: string[] | undefined;
+        tags?: string[] | undefined;
+        tools?: string[] | undefined;
+        capabilities?: string[] | undefined;
+        runtime?: string | undefined;
+        publisher?: string | undefined;
+        skills?: string[] | undefined;
+    };
+    procedure: {
+        preconditions?: string[] | undefined;
+        steps?: string[] | undefined;
+        successCriteria?: string[] | undefined;
+        rawMarkdown?: string | undefined;
+    };
+}>;
+export type SkillManifest = z.infer<typeof SkillManifestSchema>;
+export declare const SkillRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    manifest: z.ZodObject<{
+        metadata: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodString;
+            version: z.ZodString;
+            tools: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            mcp: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            skills: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            capabilities: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            runtime: z.ZodDefault<z.ZodString>;
+            tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            publisher: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            version: string;
+            id: string;
+            mcp: string[];
+            tags: string[];
+            description: string;
+            tools: string[];
+            capabilities: string[];
+            runtime: string;
+            publisher: string;
+            skills: string[];
+        }, {
+            name: string;
+            version: string;
+            id: string;
+            description: string;
+            mcp?: string[] | undefined;
+            tags?: string[] | undefined;
+            tools?: string[] | undefined;
+            capabilities?: string[] | undefined;
+            runtime?: string | undefined;
+            publisher?: string | undefined;
+            skills?: string[] | undefined;
+        }>;
+        procedure: z.ZodObject<{
+            preconditions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            steps: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            successCriteria: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            rawMarkdown: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            preconditions: string[];
+            steps: string[];
+            successCriteria: string[];
+            rawMarkdown: string;
+        }, {
+            preconditions?: string[] | undefined;
+            steps?: string[] | undefined;
+            successCriteria?: string[] | undefined;
+            rawMarkdown?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        metadata: {
+            name: string;
+            version: string;
+            id: string;
+            mcp: string[];
+            tags: string[];
+            description: string;
+            tools: string[];
+            capabilities: string[];
+            runtime: string;
+            publisher: string;
+            skills: string[];
+        };
+        procedure: {
+            preconditions: string[];
+            steps: string[];
+            successCriteria: string[];
+            rawMarkdown: string;
+        };
+    }, {
+        metadata: {
+            name: string;
+            version: string;
+            id: string;
+            description: string;
+            mcp?: string[] | undefined;
+            tags?: string[] | undefined;
+            tools?: string[] | undefined;
+            capabilities?: string[] | undefined;
+            runtime?: string | undefined;
+            publisher?: string | undefined;
+            skills?: string[] | undefined;
+        };
+        procedure: {
+            preconditions?: string[] | undefined;
+            steps?: string[] | undefined;
+            successCriteria?: string[] | undefined;
+            rawMarkdown?: string | undefined;
+        };
+    }>;
+    trustState: z.ZodDefault<z.ZodEnum<["unknown", "reviewed", "trusted", "blocked"]>>;
+    lifecycleState: z.ZodDefault<z.ZodEnum<["discovered", "validated", "installed", "enabled", "disabled", "loading", "loaded", "failed"]>>;
+    installPath: z.ZodOptional<z.ZodString>;
+    projectPin: z.ZodOptional<z.ZodString>;
+    installedAt: z.ZodOptional<z.ZodString>;
+    lastLoadedAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    manifest: {
+        metadata: {
+            name: string;
+            version: string;
+            id: string;
+            mcp: string[];
+            tags: string[];
+            description: string;
+            tools: string[];
+            capabilities: string[];
+            runtime: string;
+            publisher: string;
+            skills: string[];
+        };
+        procedure: {
+            preconditions: string[];
+            steps: string[];
+            successCriteria: string[];
+            rawMarkdown: string;
+        };
+    };
+    trustState: "trusted" | "unknown" | "blocked" | "reviewed";
+    lifecycleState: "failed" | "disabled" | "enabled" | "discovered" | "validated" | "installed" | "loading" | "loaded";
+    installPath?: string | undefined;
+    installedAt?: string | undefined;
+    projectPin?: string | undefined;
+    lastLoadedAt?: string | undefined;
+}, {
+    id: string;
+    manifest: {
+        metadata: {
+            name: string;
+            version: string;
+            id: string;
+            description: string;
+            mcp?: string[] | undefined;
+            tags?: string[] | undefined;
+            tools?: string[] | undefined;
+            capabilities?: string[] | undefined;
+            runtime?: string | undefined;
+            publisher?: string | undefined;
+            skills?: string[] | undefined;
+        };
+        procedure: {
+            preconditions?: string[] | undefined;
+            steps?: string[] | undefined;
+            successCriteria?: string[] | undefined;
+            rawMarkdown?: string | undefined;
+        };
+    };
+    trustState?: "trusted" | "unknown" | "blocked" | "reviewed" | undefined;
+    lifecycleState?: "failed" | "disabled" | "enabled" | "discovered" | "validated" | "installed" | "loading" | "loaded" | undefined;
+    installPath?: string | undefined;
+    installedAt?: string | undefined;
+    projectPin?: string | undefined;
+    lastLoadedAt?: string | undefined;
+}>;
+export type SkillRecord = z.infer<typeof SkillRecordSchema>;
+export declare const SkillTestFixtureSchema: z.ZodObject<{
+    id: z.ZodString;
+    skillId: z.ZodString;
+    inputProject: z.ZodDefault<z.ZodString>;
+    expectedCommands: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    expectedArtifacts: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    expectedVerification: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    skillId: string;
+    inputProject: string;
+    expectedCommands: string[];
+    expectedArtifacts: string[];
+    expectedVerification: string[];
+}, {
+    id: string;
+    skillId: string;
+    inputProject?: string | undefined;
+    expectedCommands?: string[] | undefined;
+    expectedArtifacts?: string[] | undefined;
+    expectedVerification?: string[] | undefined;
+}>;
+export type SkillTestFixture = z.infer<typeof SkillTestFixtureSchema>;
+export declare const SkillTestResultSchema: z.ZodObject<{
+    skillId: z.ZodString;
+    passed: z.ZodBoolean;
+    durationMs: z.ZodNumber;
+    assertions: z.ZodArray<z.ZodObject<{
+        assertion: z.ZodString;
+        passed: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        passed: boolean;
+        assertion: string;
+        error?: string | undefined;
+    }, {
+        passed: boolean;
+        assertion: string;
+        error?: string | undefined;
+    }>, "many">;
+    artifactsProduced: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    durationMs: number;
+    skillId: string;
+    passed: boolean;
+    assertions: {
+        passed: boolean;
+        assertion: string;
+        error?: string | undefined;
+    }[];
+    artifactsProduced: string[];
+}, {
+    durationMs: number;
+    skillId: string;
+    passed: boolean;
+    assertions: {
+        passed: boolean;
+        assertion: string;
+        error?: string | undefined;
+    }[];
+    artifactsProduced?: string[] | undefined;
+}>;
+export type SkillTestResult = z.infer<typeof SkillTestResultSchema>;
+export declare const SkillExecutionRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    skillId: z.ZodString;
+    version: z.ZodString;
+    projectId: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodOptional<z.ZodString>;
+    contextRevision: z.ZodOptional<z.ZodNumber>;
+    toolsUsed: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    mcpUsed: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    result: z.ZodDefault<z.ZodString>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    id: string;
+    projectId: string;
+    timestamp: string;
+    result: string;
+    skillId: string;
+    toolsUsed: string[];
+    mcpUsed: string[];
+    sessionId?: string | undefined;
+    taskId?: string | undefined;
+    contextRevision?: number | undefined;
+}, {
+    version: string;
+    id: string;
+    projectId: string;
+    timestamp: string;
+    skillId: string;
+    sessionId?: string | undefined;
+    taskId?: string | undefined;
+    result?: string | undefined;
+    contextRevision?: number | undefined;
+    toolsUsed?: string[] | undefined;
+    mcpUsed?: string[] | undefined;
+}>;
+export type SkillExecutionRecord = z.infer<typeof SkillExecutionRecordSchema>;
+export declare const SkillPinMapSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+export type SkillPinMap = z.infer<typeof SkillPinMapSchema>;
+//# sourceMappingURL=skill.d.ts.map

package/dist/domain/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/domain/skill.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,yBAAyB,2GASpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,qBAAqB,0DAKhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;EAOjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,iBAAiB,uCAAmC,CAAC;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/domain/skill.js

@@ -0,0 +1,109 @@
+/**
+ * Anantham V2 — Skill Domain Contracts
+ *
+ * Defines authoritative domain models, types, and runtime Zod schemas for
+ * Skill manifests, frontmatter, procedures, metadata indices, test fixtures,
+ * execution provenance records, and lifecycle states.
+ */
+import { z } from "zod";
+export const SkillLifecycleStateSchema = z.enum([
+    "discovered",
+    "validated",
+    "installed",
+    "enabled",
+    "disabled",
+    "loading",
+    "loaded",
+    "failed",
+]);
+export const SkillTrustStateSchema = z.enum([
+    "unknown",
+    "reviewed",
+    "trusted",
+    "blocked",
+]);
+export const SkillFrontmatterSchema = z.object({
+    name: z.string().min(1),
+    description: z.string().min(1),
+    version: z
+        .string()
+        .min(1)
+        .regex(/^\d+\.\d+\.\d+(-[a-zA-Z0-9\.]+)?$/, "Version must follow semantic versioning (SemVer)"),
+    tools: z.array(z.string()).optional().default([]),
+    mcp: z.array(z.string()).optional().default([]),
+    skills: z.array(z.string()).optional().default([]),
+    capabilities: z.array(z.string()).optional().default([]),
+    runtime: z.string().optional().default("anantham>=2.0"),
+    tags: z.array(z.string()).optional().default([]),
+    publisher: z.string().optional().default("local"),
+});
+export const SkillMetadataSchema = z.object({
+    id: z
+        .string()
+        .min(1)
+        .regex(/^[a-zA-Z0-9_\-\.]+$/, "Skill ID must be alphanumeric with dashes, dots, or underscores"),
+    name: z.string().min(1),
+    description: z.string().min(1),
+    version: z.string().min(1),
+    tools: z.array(z.string()).default([]),
+    mcp: z.array(z.string()).default([]),
+    skills: z.array(z.string()).default([]),
+    capabilities: z.array(z.string()).default([]),
+    runtime: z.string().default("anantham>=2.0"),
+    tags: z.array(z.string()).default([]),
+    publisher: z.string().default("local"),
+});
+export const SkillProcedureSchema = z.object({
+    preconditions: z.array(z.string()).default([]),
+    steps: z.array(z.string()).default([]),
+    successCriteria: z.array(z.string()).default([]),
+    rawMarkdown: z.string().default(""),
+});
+export const SkillManifestSchema = z.object({
+    metadata: SkillMetadataSchema,
+    procedure: SkillProcedureSchema,
+});
+export const SkillRecordSchema = z.object({
+    id: z.string().min(1),
+    manifest: SkillManifestSchema,
+    trustState: SkillTrustStateSchema.default("unknown"),
+    lifecycleState: SkillLifecycleStateSchema.default("discovered"),
+    installPath: z.string().optional(),
+    projectPin: z.string().optional(),
+    installedAt: z.string().datetime().optional(),
+    lastLoadedAt: z.string().datetime().optional(),
+});
+export const SkillTestFixtureSchema = z.object({
+    id: z.string().min(1),
+    skillId: z.string().min(1),
+    inputProject: z.string().default(""),
+    expectedCommands: z.array(z.string()).default([]),
+    expectedArtifacts: z.array(z.string()).default([]),
+    expectedVerification: z.array(z.string()).default([]),
+});
+export const SkillTestResultSchema = z.object({
+    skillId: z.string().min(1),
+    passed: z.boolean(),
+    durationMs: z.number().nonnegative(),
+    assertions: z.array(z.object({
+        assertion: z.string(),
+        passed: z.boolean(),
+        error: z.string().optional(),
+    })),
+    artifactsProduced: z.array(z.string()).default([]),
+});
+export const SkillExecutionRecordSchema = z.object({
+    id: z.string().min(1),
+    skillId: z.string().min(1),
+    version: z.string().min(1),
+    projectId: z.string().min(1),
+    sessionId: z.string().optional(),
+    taskId: z.string().optional(),
+    contextRevision: z.number().int().nonnegative().optional(),
+    toolsUsed: z.array(z.string()).default([]),
+    mcpUsed: z.array(z.string()).default([]),
+    result: z.string().default("success"),
+    timestamp: z.string().datetime(),
+});
+export const SkillPinMapSchema = z.record(z.string(), z.string());
+//# sourceMappingURL=skill.js.map

package/dist/domain/skill.js.map

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

package/dist/domain/task.d.ts

@@ -0,0 +1,91 @@
+import { z } from "zod";
+/**
+ * Durable Task lifecycle status.
+ * PRD Part 1 Section 100, PRD Part 2 Section 34.
+ */
+export declare const TaskStatusSchema: z.ZodEnum<["queued", "available", "claimed", "running", "waiting_approval", "waiting_resource", "blocked", "paused", "review", "verifying", "completed", "failed", "cancelled"]>;
+export type TaskStatus = z.infer<typeof TaskStatusSchema>;
+/**
+ * Task priority classification.
+ * PRD Part 1 Section 102.
+ */
+export declare const TaskPrioritySchema: z.ZodEnum<["critical", "high", "normal", "low"]>;
+export type TaskPriority = z.infer<typeof TaskPrioritySchema>;
+/**
+ * Durable Task contract.
+ * PRD Part 1 Section 100 (PRD-TASK-001).
+ */
+export declare const TaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    projectId: z.ZodString;
+    sessionId: z.ZodString;
+    parentId: z.ZodOptional<z.ZodString>;
+    objective: z.ZodString;
+    status: z.ZodEnum<["queued", "available", "claimed", "running", "waiting_approval", "waiting_resource", "blocked", "paused", "review", "verifying", "completed", "failed", "cancelled"]>;
+    priority: z.ZodEnum<["critical", "high", "normal", "low"]>;
+    agentRole: z.ZodOptional<z.ZodString>;
+    modelProfile: z.ZodOptional<z.ZodString>;
+    keyPoolProfile: z.ZodOptional<z.ZodString>;
+    permissionProfile: z.ZodOptional<z.ZodString>;
+    dependencies: z.ZodArray<z.ZodString, "many">;
+    inputArtifacts: z.ZodArray<z.ZodString, "many">;
+    outputArtifacts: z.ZodArray<z.ZodString, "many">;
+    checkpointId: z.ZodOptional<z.ZodString>;
+    readSet: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    writeSet: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    status: "failed" | "paused" | "completed" | "queued" | "available" | "claimed" | "running" | "waiting_approval" | "waiting_resource" | "blocked" | "review" | "verifying" | "cancelled";
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    projectId: string;
+    sessionId: string;
+    priority: "normal" | "critical" | "high" | "low";
+    objective: string;
+    dependencies: string[];
+    inputArtifacts: string[];
+    outputArtifacts: string[];
+    metadata?: Record<string, unknown> | undefined;
+    modelProfile?: string | undefined;
+    keyPoolProfile?: string | undefined;
+    parentId?: string | undefined;
+    agentRole?: string | undefined;
+    permissionProfile?: string | undefined;
+    checkpointId?: string | undefined;
+    readSet?: string[] | undefined;
+    writeSet?: string[] | undefined;
+}, {
+    status: "failed" | "paused" | "completed" | "queued" | "available" | "claimed" | "running" | "waiting_approval" | "waiting_resource" | "blocked" | "review" | "verifying" | "cancelled";
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    projectId: string;
+    sessionId: string;
+    priority: "normal" | "critical" | "high" | "low";
+    objective: string;
+    dependencies: string[];
+    inputArtifacts: string[];
+    outputArtifacts: string[];
+    metadata?: Record<string, unknown> | undefined;
+    modelProfile?: string | undefined;
+    keyPoolProfile?: string | undefined;
+    parentId?: string | undefined;
+    agentRole?: string | undefined;
+    permissionProfile?: string | undefined;
+    checkpointId?: string | undefined;
+    readSet?: string[] | undefined;
+    writeSet?: string[] | undefined;
+}>;
+export type Task = z.infer<typeof TaskSchema>;
+/**
+ * Validates whether a state transition from `currentStatus` to `nextStatus` is allowed.
+ */
+export declare function isValidTaskTransition(currentStatus: TaskStatus, nextStatus: TaskStatus): boolean;
+/**
+ * Asserts that a state transition is valid, throwing an error if invalid.
+ */
+export declare function assertValidTaskTransition(currentStatus: TaskStatus, nextStatus: TaskStatus): void;
+//# sourceMappingURL=task.d.ts.map

package/dist/domain/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/domain/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,gBAAgB,kLAc3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,kBAAkB,kDAK7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBrB,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAiC9C;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAIhG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,CAOjG"}