@kynetic-ai/spec 0.1.0

package/dist/utils/grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../src/utils/grep.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,kFAAkF;IAClF,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,EACf,eAAe,UAAO,GACrB,SAAS,GAAG,IAAI,CAmBlB;AAgDD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAe5D"}

package/dist/utils/grep.js

@@ -0,0 +1,86 @@
+/**
+ * Grep-like content search across item fields.
+ *
+ * Recursively searches all text content (title, description, notes, AC text)
+ * and returns matched field paths.
+ */
+/**
+ * Search an item for a regex pattern across all text fields.
+ *
+ * @param item - The item to search
+ * @param pattern - Regex pattern string
+ * @param caseInsensitive - Whether to match case-insensitively (default: true)
+ * @returns GrepMatch with matched field paths, or null if no matches
+ */
+export function grepItem(item, pattern, caseInsensitive = true) {
+    const flags = caseInsensitive ? 'i' : '';
+    let regex;
+    try {
+        regex = new RegExp(pattern, flags);
+    }
+    catch {
+        // Invalid regex - treat as literal string
+        regex = new RegExp(escapeRegex(pattern), flags);
+    }
+    const matchedFields = [];
+    searchObject(item, '', regex, matchedFields);
+    if (matchedFields.length === 0) {
+        return null;
+    }
+    return { matchedFields };
+}
+/**
+ * Recursively search an object for regex matches in string values.
+ */
+function searchObject(obj, path, regex, matches) {
+    if (obj === null || obj === undefined) {
+        return;
+    }
+    if (typeof obj === 'string') {
+        if (regex.test(obj)) {
+            matches.push(path);
+        }
+        return;
+    }
+    if (Array.isArray(obj)) {
+        for (let i = 0; i < obj.length; i++) {
+            const arrayPath = path ? `${path}[${i}]` : `[${i}]`;
+            searchObject(obj[i], arrayPath, regex, matches);
+        }
+        return;
+    }
+    if (typeof obj === 'object') {
+        // Skip internal fields (starting with _)
+        for (const [key, value] of Object.entries(obj)) {
+            if (key.startsWith('_'))
+                continue;
+            const fieldPath = path ? `${path}.${key}` : key;
+            searchObject(value, fieldPath, regex, matches);
+        }
+    }
+}
+/**
+ * Escape special regex characters in a string.
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Format matched fields for display.
+ * Groups and simplifies paths for readability.
+ */
+export function formatMatchedFields(fields) {
+    if (fields.length === 0)
+        return '';
+    // Simplify common patterns
+    const simplified = fields.map(field => {
+        // "acceptance_criteria[0].given" -> "ac[0].given"
+        return field
+            .replace(/^acceptance_criteria/, 'ac')
+            .replace(/\.content$/, ''); // notes[0].content -> notes[0]
+    });
+    // Deduplicate
+    const unique = [...new Set(simplified)];
+    return unique.join(', ');
+}
+//# sourceMappingURL=grep.js.map

package/dist/utils/grep.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+export { parseTimeSpec, formatRelativeTime } from './time.js';
+export { isGitRepo, getCurrentBranch, getRecentCommits, getWorkingTreeStatus, getDiffSince, } from './git.js';
+export type { GitCommit, GitWorkingTree, GitFileStatus } from './git.js';
+export { formatCommitGuidance, printCommitGuidance } from './commit.js';
+export type { CommitGuidance } from './commit.js';
+export { grepItem, formatMatchedFields } from './grep.js';
+export type { GrepMatch } from './grep.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACxE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC1D,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,6 @@
+// Re-export utilities
+export { parseTimeSpec, formatRelativeTime } from './time.js';
+export { isGitRepo, getCurrentBranch, getRecentCommits, getWorkingTreeStatus, getDiffSince, } from './git.js';
+export { formatCommitGuidance, printCommitGuidance } from './commit.js';
+export { grepItem, formatMatchedFields } from './grep.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,sBAAsB;AAEtB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,GACb,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/utils/time.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Time parsing and formatting utilities
+ */
+/**
+ * Parse a time specification into a Date.
+ * Supports:
+ * - ISO8601: "2026-01-14T10:00:00Z", "2026-01-14"
+ * - Relative: "1h" (1 hour ago), "2d" (2 days ago), "1w" (1 week ago), "1m" (1 month ago)
+ *
+ * @param timeSpec The time specification string
+ * @returns Date object, or null if invalid
+ */
+export declare function parseTimeSpec(timeSpec: string): Date | null;
+/**
+ * Format a Date as a human-readable relative time (e.g., "2 hours ago")
+ */
+export declare function formatRelativeTime(date: Date): string;
+//# sourceMappingURL=time.d.ts.map

package/dist/utils/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CA2B3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAgBrD"}

package/dist/utils/time.js

@@ -0,0 +1,61 @@
+/**
+ * Time parsing and formatting utilities
+ */
+/**
+ * Parse a time specification into a Date.
+ * Supports:
+ * - ISO8601: "2026-01-14T10:00:00Z", "2026-01-14"
+ * - Relative: "1h" (1 hour ago), "2d" (2 days ago), "1w" (1 week ago), "1m" (1 month ago)
+ *
+ * @param timeSpec The time specification string
+ * @returns Date object, or null if invalid
+ */
+export function parseTimeSpec(timeSpec) {
+    // Try ISO8601 first
+    const isoDate = new Date(timeSpec);
+    if (!isNaN(isoDate.getTime())) {
+        return isoDate;
+    }
+    // Try relative time (e.g., "1h", "2d", "1w", "1m")
+    const relativeMatch = timeSpec.match(/^(\d+)([hdwm])$/i);
+    if (relativeMatch) {
+        const amount = parseInt(relativeMatch[1], 10);
+        const unit = relativeMatch[2].toLowerCase();
+        const now = new Date();
+        switch (unit) {
+            case 'h':
+                return new Date(now.getTime() - amount * 60 * 60 * 1000);
+            case 'd':
+                return new Date(now.getTime() - amount * 24 * 60 * 60 * 1000);
+            case 'w':
+                return new Date(now.getTime() - amount * 7 * 24 * 60 * 60 * 1000);
+            case 'm':
+                return new Date(now.getTime() - amount * 30 * 24 * 60 * 60 * 1000);
+        }
+    }
+    return null;
+}
+/**
+ * Format a Date as a human-readable relative time (e.g., "2 hours ago")
+ */
+export function formatRelativeTime(date) {
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    const diffMins = Math.floor(diffMs / (60 * 1000));
+    const diffHours = Math.floor(diffMs / (60 * 60 * 1000));
+    const diffDays = Math.floor(diffMs / (24 * 60 * 60 * 1000));
+    if (diffMins < 1)
+        return 'just now';
+    if (diffMins < 60)
+        return `${diffMins} minute${diffMins === 1 ? '' : 's'} ago`;
+    if (diffHours < 24)
+        return `${diffHours} hour${diffHours === 1 ? '' : 's'} ago`;
+    if (diffDays < 7)
+        return `${diffDays} day${diffDays === 1 ? '' : 's'} ago`;
+    if (diffDays < 30) {
+        const weeks = Math.floor(diffDays / 7);
+        return `${weeks} week${weeks === 1 ? '' : 's'} ago`;
+    }
+    return date.toLocaleDateString();
+}
+//# sourceMappingURL=time.js.map

package/dist/utils/time.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@kynetic-ai/spec",
+  "version": "0.1.0",
+  "description": "Kynetic Spec - Structured specification format for human-AI collaboration",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "kspec": "./dist/cli/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kynetic-ai/kynetic-spec.git"
+  },
+  "homepage": "https://github.com/kynetic-ai/kynetic-spec#readme",
+  "bugs": {
+    "url": "https://github.com/kynetic-ai/kynetic-spec/issues"
+  },
+  "author": "Kynetic AI",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli/index.ts",
+    "setup:dev": "npm install && npm run build && npm link",
+    "pretest": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "cli-table3": "^0.6.5",
+    "commander": "^12.1.0",
+    "js-yaml": "^4.1.0",
+    "ulid": "^2.3.0",
+    "yaml": "^2.8.2",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@agentclientprotocol/sdk": "^0.13.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.11.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.17"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "specification",
+    "requirements",
+    "yaml",
+    "cli",
+    "ai",
+    "agent"
+  ],
+  "license": "MIT"
+}