@kynetic-ai/spec 0.1.2 → 0.3.0

package/dist/parser/items.d.ts

@@ -4,8 +4,8 @@
  * Provides filtering by type, tags, status, and field presence.
  * Complements ReferenceIndex which handles @reference resolution.
  */
-import type { LoadedSpecItem, LoadedTask, AnyLoadedItem } from './yaml.js';
-import type { ItemType, TaskStatus, Maturity, ImplementationStatus } from '../schema/index.js';
+import type { ImplementationStatus, ItemType, Maturity, TaskStatus } from "../schema/index.js";
+import type { AnyLoadedItem, LoadedSpecItem, LoadedTask } from "./yaml.js";
 /**
  * Filter criteria for item queries
  */
@@ -130,6 +130,12 @@ export declare class ItemIndex {
      */
     get specItemCount(): number;
 }
+/**
+ * Find all descendant items of a parent item based on _path and _sourceFile.
+ * Descendants are items in the same source file whose _path starts with the parent's _path.
+ * AC: @module-scoped-item-listing ac-nested-descendants
+ */
+export declare function findDescendantItems(parent: LoadedSpecItem, allItems: LoadedSpecItem[]): LoadedSpecItem[];
 /**
  * Find direct child items of a parent item based on _path
  * Children have paths like "parent_path.field[N]"

package/dist/parser/items.d.ts.map

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

package/dist/parser/items.js

@@ -4,7 +4,7 @@
  * Provides filtering by type, tags, status, and field presence.
  * Complements ReferenceIndex which handles @reference resolution.
  */
-import { grepItem } from '../utils/grep.js';
+import { grepItem } from "../utils/grep.js";
 // ============================================================
 // ITEM INDEX
 // ============================================================
@@ -43,26 +43,28 @@ export class ItemIndex {
     }
     indexItem(item) {
         // Index by type
-        const type = item.type || 'unknown';
+        const type = item.type || "unknown";
         const typeList = this.typeIndex.get(type) || [];
         typeList.push(item);
         this.typeIndex.set(type, typeList);
         // Index by tags
-        const tags = 'tags' in item ? item.tags : [];
+        const tags = "tags" in item ? item.tags : [];
         for (const tag of tags) {
             const tagList = this.tagIndex.get(tag) || [];
             tagList.push(item);
             this.tagIndex.set(tag, tagList);
         }
         // Index tasks by status
-        if ('status' in item && typeof item.status === 'string') {
+        if ("status" in item && typeof item.status === "string") {
             const task = item;
             const statusList = this.statusIndex.get(task.status) || [];
             statusList.push(task);
             this.statusIndex.set(task.status, statusList);
         }
         // Index spec items by maturity/implementation
-        if ('status' in item && typeof item.status === 'object' && item.status !== null) {
+        if ("status" in item &&
+            typeof item.status === "object" &&
+            item.status !== null) {
             const specItem = item;
             const status = specItem.status;
             if (status.maturity) {
@@ -95,36 +97,42 @@ export class ItemIndex {
         // Apply type filter
         if (filter.type) {
             const types = Array.isArray(filter.type) ? filter.type : [filter.type];
-            results = results.filter(item => types.includes(item.type));
+            results = results.filter((item) => types.includes(item.type));
         }
         // Apply tag filter (ANY)
         if (filter.tags && filter.tags.length > 0) {
-            results = results.filter(item => {
-                const itemTags = 'tags' in item ? item.tags : [];
-                return filter.tags.some(tag => itemTags.includes(tag));
+            results = results.filter((item) => {
+                const itemTags = "tags" in item ? item.tags : [];
+                return filter.tags?.some((tag) => itemTags.includes(tag));
             });
         }
         // Apply tag filter (ALL)
         if (filter.allTags && filter.allTags.length > 0) {
-            results = results.filter(item => {
-                const itemTags = 'tags' in item ? item.tags : [];
-                return filter.allTags.every(tag => itemTags.includes(tag));
+            results = results.filter((item) => {
+                const itemTags = "tags" in item ? item.tags : [];
+                return filter.allTags?.every((tag) => itemTags.includes(tag));
             });
         }
         // Apply task status filter
         if (filter.status) {
-            const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
-            results = results.filter(item => {
-                if (!('status' in item) || typeof item.status !== 'string')
+            const statuses = Array.isArray(filter.status)
+                ? filter.status
+                : [filter.status];
+            results = results.filter((item) => {
+                if (!("status" in item) || typeof item.status !== "string")
                     return false;
                 return statuses.includes(item.status);
             });
         }
         // Apply maturity filter
         if (filter.maturity) {
-            const maturities = Array.isArray(filter.maturity) ? filter.maturity : [filter.maturity];
-            results = results.filter(item => {
-                if (!('status' in item) || typeof item.status !== 'object' || !item.status)
+            const maturities = Array.isArray(filter.maturity)
+                ? filter.maturity
+                : [filter.maturity];
+            results = results.filter((item) => {
+                if (!("status" in item) ||
+                    typeof item.status !== "object" ||
+                    !item.status)
                     return false;
                 const status = item.status;
                 return status.maturity && maturities.includes(status.maturity);
@@ -132,9 +140,13 @@ export class ItemIndex {
         }
         // Apply implementation filter
         if (filter.implementation) {
-            const impls = Array.isArray(filter.implementation) ? filter.implementation : [filter.implementation];
-            results = results.filter(item => {
-                if (!('status' in item) || typeof item.status !== 'object' || !item.status)
+            const impls = Array.isArray(filter.implementation)
+                ? filter.implementation
+                : [filter.implementation];
+            results = results.filter((item) => {
+                if (!("status" in item) ||
+                    typeof item.status !== "object" ||
+                    !item.status)
                     return false;
                 const status = item.status;
                 return status.implementation && impls.includes(status.implementation);
@@ -142,9 +154,9 @@ export class ItemIndex {
         }
         // Apply has-fields filter
         if (filter.hasFields && filter.hasFields.length > 0) {
-            results = results.filter(item => {
+            results = results.filter((item) => {
                 const obj = item;
-                return filter.hasFields.every(field => {
+                return filter.hasFields?.every((field) => {
                     const value = getNestedField(obj, field);
                     return value !== undefined && value !== null;
                 });
@@ -152,9 +164,9 @@ export class ItemIndex {
         }
         // Apply field-equals filter
         if (filter.fieldEquals && filter.fieldEquals.length > 0) {
-            results = results.filter(item => {
+            results = results.filter((item) => {
                 const obj = item;
-                return filter.fieldEquals.every(({ field, value }) => {
+                return filter.fieldEquals?.every(({ field, value }) => {
                     const itemValue = getNestedField(obj, field);
                     return itemValue === value;
                 });
@@ -163,11 +175,11 @@ export class ItemIndex {
         // Apply title search
         if (filter.titleContains) {
             const search = filter.titleContains.toLowerCase();
-            results = results.filter(item => item.title.toLowerCase().includes(search));
+            results = results.filter((item) => item.title.toLowerCase().includes(search));
         }
         // Apply grep search (regex across all text content)
         if (filter.grepSearch) {
-            results = results.filter(item => {
+            results = results.filter((item) => {
                 const match = grepItem(item, filter.grepSearch);
                 return match !== null;
             });
@@ -276,26 +288,50 @@ export class ItemIndex {
  * e.g., "status.maturity" -> item.status.maturity
  */
 function getNestedField(obj, path) {
-    const parts = path.split('.');
+    const parts = path.split(".");
     let current = obj;
     for (const part of parts) {
         if (current === null || current === undefined)
             return undefined;
-        if (typeof current !== 'object')
+        if (typeof current !== "object")
             return undefined;
         current = current[part];
     }
     return current;
 }
+/**
+ * Find all descendant items of a parent item based on _path and _sourceFile.
+ * Descendants are items in the same source file whose _path starts with the parent's _path.
+ * AC: @module-scoped-item-listing ac-nested-descendants
+ */
+export function findDescendantItems(parent, allItems) {
+    const parentPath = parent._path || "";
+    const parentSourceFile = parent._sourceFile;
+    return allItems.filter((item) => {
+        if (item._ulid === parent._ulid)
+            return false; // Skip self
+        if (item._sourceFile !== parentSourceFile)
+            return false; // Must be same source file
+        // If parent is at root (empty path), all items from same source file are descendants
+        if (parentPath === "") {
+            return true;
+        }
+        // Item's path must start with parent's path followed by a dot
+        // e.g., parent "features[0]" matches child "features[0].requirements[1]"
+        if (!item._path)
+            return false;
+        return item._path.startsWith(`${parentPath}.`);
+    });
+}
 /**
  * Find direct child items of a parent item based on _path
  * Children have paths like "parent_path.field[N]"
  */
 export function findChildItems(parent, allItems) {
     // Handle both cases: parent at root and nested parent
-    const parentPath = parent._path || '';
+    const parentPath = parent._path || "";
     // Look for items whose path starts with parent's path
-    return allItems.filter(item => {
+    return allItems.filter((item) => {
         if (!item._path)
             return false;
         if (item._ulid === parent._ulid)
@@ -304,18 +340,18 @@ export function findChildItems(parent, allItems) {
         // Examples:
         // - Parent: "features[0]", Child: "features[0].requirements[0]"
         // - Parent: "", Child: "features[0]"
-        if (parentPath === '') {
+        if (parentPath === "") {
             // Root level parent - children are top-level items like "features[0]"
-            return !item._path.includes('.');
+            return !item._path.includes(".");
         }
         // Nested parent - children start with parent path + dot
-        if (!item._path.startsWith(parentPath + '.')) {
+        if (!item._path.startsWith(`${parentPath}.`)) {
             return false;
         }
         // Must be direct child (no additional nesting)
         // Remove parent prefix and check for no more dots
         const remainder = item._path.slice(parentPath.length + 1);
-        return !remainder.includes('.');
+        return !remainder.includes(".");
     });
 }
 //# sourceMappingURL=items.js.map

package/dist/parser/items.js.map

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

package/dist/parser/meta.d.ts

@@ -7,8 +7,8 @@
  * - Conventions: project rules and standards
  * - Observations: feedback about processes
  */
-import { type MetaManifest, type Agent, type Workflow, type Convention, type Observation, type MetaItem, type ObservationType, type SessionContext, getMetaItemType } from '../schema/index.js';
-import type { KspecContext } from './yaml.js';
+import { type Agent, type Convention, getMetaItemType, isSkill, type MetaItem, type MetaManifest, type Observation, type ObservationType, type SessionContext, type Skill, type Workflow, type WorkflowRun } from "../schema/index.js";
+import type { KspecContext } from "./yaml.js";
 /**
  * Loaded agent with runtime metadata
  */
@@ -33,10 +33,16 @@ export interface LoadedConvention extends Convention {
 export interface LoadedObservation extends Observation {
     _sourceFile?: string;
 }
+/**
+ * Loaded skill with runtime metadata
+ */
+export interface LoadedSkill extends Skill {
+    _sourceFile?: string;
+}
 /**
  * Any loaded meta item
  */
-export type LoadedMetaItem = LoadedAgent | LoadedWorkflow | LoadedConvention | LoadedObservation;
+export type LoadedMetaItem = LoadedAgent | LoadedWorkflow | LoadedConvention | LoadedObservation | LoadedSkill;
 /**
  * Meta context containing all loaded meta items
  */
@@ -47,19 +53,30 @@ export interface MetaContext {
     workflows: LoadedWorkflow[];
     conventions: LoadedConvention[];
     observations: LoadedObservation[];
+    skills: LoadedSkill[];
 }
 /**
- * Find the meta manifest file (kynetic.meta.yaml)
+ * Find the meta manifest file.
+ *
+ * Discovery algorithm:
+ * 1. Check for explicit name: kynetic.meta.yaml (backward compat)
+ * 2. If not found, scan directory for *.meta.yaml files
+ * 3. For each candidate, validate it contains a 'kynetic_meta:' version field
+ * 4. Return first valid match (alphabetically after explicit name)
+ *
+ * AC: @meta-manifest-discovery ac-1, ac-2, ac-3
  */
 export declare function findMetaManifest(specDir: string): Promise<string | null>;
 /**
  * Get the meta manifest file path.
+ * Derives from main manifest name (e.g., myproject.yaml -> myproject.meta.yaml)
  * Returns path even if file doesn't exist yet.
  */
 export declare function getMetaManifestPath(ctx: KspecContext): string;
 /**
  * Load the meta context from a kspec context.
  * Loads meta manifest and follows includes.
+ * AC: @skill-meta-type ac-4 - MetaContext.skills contains LoadedSkill objects with _sourceFile set
  */
 export declare function loadMetaContext(ctx: KspecContext): Promise<MetaContext>;
 /**
@@ -71,9 +88,40 @@ export declare function getMetaStats(meta: MetaContext): {
     conventions: number;
     observations: number;
     unresolvedObservations: number;
+    skills: number;
 };
+/**
+ * Meta item type string literal
+ */
+export type MetaItemTypeName = "agent" | "workflow" | "convention" | "observation" | "skill";
+/**
+ * Result of resolving a meta reference
+ */
+export interface ResolvedMetaRef {
+    item: LoadedMetaItem;
+    type: MetaItemTypeName;
+    ulid: string;
+}
+/**
+ * Resolve a meta reference to its item, type, and ULID.
+ *
+ * This is the unified resolver for meta items that consolidates various
+ * ref-to-item resolution patterns. Handles ULID prefixes, full ULIDs,
+ * semantic IDs (id field for agents/workflows/skills), and domains (conventions).
+ *
+ * AC: @skill-meta-type ac-5 - skills returned by semantic id lookup
+ * AC: @skill-meta-type ac-6 - skills returned by ULID prefix lookup
+ * AC: @skill-meta-integration ac-4 - skills included in resolution
+ */
+export declare function resolveMetaRef(meta: MetaContext, ref: string): ResolvedMetaRef | null;
 /**
  * Find a meta item by reference (ULID, short ULID, or id)
+ *
+ * This is a convenience wrapper around resolveMetaRef that returns just the item.
+ * Use resolveMetaRef when you also need the type and ULID.
+ *
+ * AC: @skill-meta-type ac-5 - skills returned by semantic id lookup
+ * AC: @skill-meta-type ac-6 - skills returned by ULID prefix lookup
  */
 export declare function findMetaItemByRef(meta: MetaContext, ref: string): LoadedMetaItem | undefined;
 /**
@@ -86,6 +134,8 @@ export declare function isMetaItemType(type: string): boolean;
 export declare function createObservation(type: ObservationType, content: string, options?: {
     workflow_ref?: string;
     author?: string;
+    /** Config author from kspec.config.yaml identity.author */
+    configAuthor?: string | null;
 }): Observation;
 /**
  * Save an observation to the meta manifest
@@ -95,16 +145,94 @@ export declare function saveObservation(ctx: KspecContext, observation: LoadedOb
  * Delete an observation from the meta manifest
  */
 export declare function deleteObservation(ctx: KspecContext, ulid: string): Promise<boolean>;
-export { getMetaItemType };
-export type { Agent, Workflow, Convention, Observation, MetaItem };
 /**
- * Save any meta item (agent, workflow, convention) to the manifest
+ * Get the path for skill content file.
+ * Skills are stored in .kspec/skills/<id>/SKILL.md
+ */
+export declare function getSkillContentPath(ctx: KspecContext, skillId: string): string;
+/**
+ * Load skill content from the SKILL.md file.
+ * AC: @skill-meta-type ac-3 - loadSkillContent returns full markdown content
+ * AC: @skill-content-model ac-1 - loadSkillContent returns markdown content as a string
+ */
+export declare function loadSkillContent(ctx: KspecContext, skill: LoadedSkill): Promise<string | null>;
+/**
+ * Skill doc object returned by loadSkillDocs.
+ * AC: @skill-content-model ac-2
  */
-export declare function saveMetaItem(ctx: KspecContext, item: LoadedMetaItem, itemType: 'agent' | 'workflow' | 'convention'): Promise<void>;
+export interface SkillDoc {
+    /** File name (e.g., "quickref.md") */
+    name: string;
+    /** Full file path */
+    path: string;
+    /** File content */
+    content: string;
+}
+/**
+ * Supported skill supporting directory types.
+ * AC: @supporting-files-convention ac-1
+ */
+export type SupportingDirType = "references" | "scripts" | "assets" | "docs";
+/**
+ * A file from a skill's supporting directory.
+ * AC: @supporting-files-convention ac-1
+ */
+export interface SupportingFile {
+    /** File name (e.g., "api.md", "helper.sh") */
+    name: string;
+    /** Full file path */
+    path: string;
+    /** File content (for text files) */
+    content: string;
+    /** Supporting directory type */
+    dirType: SupportingDirType;
+}
+/**
+ * Get the docs directory path for a skill.
+ * Skills can have supporting docs at .kspec/skills/<id>/docs/
+ */
+export declare function getSkillDocsPath(ctx: KspecContext, skillId: string): string;
+/**
+ * Load skill documentation files from the docs/ subdirectory.
+ * AC: @skill-content-model ac-2 - loadSkillDocs returns array of doc objects
+ */
+export declare function loadSkillDocs(ctx: KspecContext, skill: LoadedSkill): Promise<SkillDoc[]>;
+/**
+ * Get the path to a supporting directory for a skill.
+ * AC: @supporting-files-convention ac-1
+ */
+export declare function getSkillSupportingDirPath(ctx: KspecContext, skillId: string, dirType: SupportingDirType): string;
+/**
+ * Load files from a skill's supporting directory.
+ * AC: @supporting-files-convention ac-1 - references files are accessible
+ *
+ * @param ctx - Kspec context
+ * @param skill - The skill to load files from
+ * @param dirType - The supporting directory type (references, scripts, assets, docs)
+ * @returns Array of files found in the directory
+ */
+export declare function loadSkillSupportingFiles(ctx: KspecContext, skill: LoadedSkill, dirType: SupportingDirType): Promise<SupportingFile[]>;
+/**
+ * List which supporting directories exist for a skill.
+ * AC: @supporting-files-convention ac-1
+ *
+ * @returns Array of directory types that exist for the skill
+ */
+export declare function listSkillSupportingDirs(ctx: KspecContext, skillId: string): Promise<SupportingDirType[]>;
+export { getMetaItemType, isSkill };
+export type { Agent, Workflow, Convention, Observation, Skill, MetaItem };
+/**
+ * Save any meta item (agent, workflow, convention, skill) to the manifest
+ * AC: @skill-parser ac-1 - skill is appended to manifest.skills and written to disk
+ * AC: @skill-parser ac-2 - .kspec/skills/<id>/ directory is created for skills
+ */
+export declare function saveMetaItem(ctx: KspecContext, item: LoadedMetaItem, itemType: "agent" | "workflow" | "convention" | "skill"): Promise<void>;
 /**
  * Delete any meta item from the manifest
+ * AC: @skill-parser ac-3 - skill is removed from manifest.skills
+ * AC: @skill-parser ac-4 - .kspec/skills/<id>/ directory is deleted for skills
  */
-export declare function deleteMetaItem(ctx: KspecContext, itemUlid: string, itemType: 'agent' | 'workflow' | 'convention' | 'observation'): Promise<boolean>;
+export declare function deleteMetaItem(ctx: KspecContext, itemUlid: string, itemType: "agent" | "workflow" | "convention" | "observation" | "skill"): Promise<boolean>;
 /**
  * Get the session context file path
  */
@@ -117,4 +245,34 @@ export declare function loadSessionContext(ctx: KspecContext): Promise<SessionCo
  * Save session context
  */
 export declare function saveSessionContext(ctx: KspecContext, context: SessionContext): Promise<void>;
+/**
+ * Get the workflow runs file path.
+ * Derives from main manifest name (e.g., myproject.yaml -> myproject.runs.yaml)
+ */
+export declare function getWorkflowRunsPath(ctx: KspecContext): string;
+/**
+ * Load workflow runs from file
+ */
+export declare function loadWorkflowRuns(ctx: KspecContext): Promise<WorkflowRun[]>;
+/**
+ * Save a workflow run (create or update)
+ */
+export declare function saveWorkflowRun(ctx: KspecContext, run: WorkflowRun): Promise<void>;
+/**
+ * Update an existing workflow run
+ */
+export declare function updateWorkflowRun(ctx: KspecContext, run: WorkflowRun): Promise<void>;
+/**
+ * Find a workflow run by reference (ULID or ULID prefix)
+ */
+export declare function findWorkflowRunByRef(ctx: KspecContext, ref: string): Promise<WorkflowRun | undefined>;
+/**
+ * Find active workflow runs
+ */
+export declare function findActiveRuns(ctx: KspecContext): Promise<WorkflowRun[]>;
+/**
+ * Delete workflow runs by ULIDs
+ * AC: @workflow-prune ac-1, ac-2, ac-3, ac-4
+ */
+export declare function deleteWorkflowRuns(ctx: KspecContext, ulidsToDelete: string[]): Promise<void>;
 //# sourceMappingURL=meta.d.ts.map

package/dist/parser/meta.d.ts.map

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