@fractary/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Fractary Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,169 @@
+# @fractary/core
+
+Fractary Core SDK - Primitive operations for work tracking, repository management, specifications, logging, file storage, and documentation.
+
+> **⚠️ Alpha Release (v0.1.0)** - This is an early-stage release with limited platform support. Only GitHub is fully implemented. Other providers (Bitbucket, GitLab, Jira, Linear) are included as stubs for future compatibility but will throw errors if used.
+
+## Overview
+
+`@fractary/core` provides foundational SDKs for common development operations across multiple platforms and services. This package is designed to be used by higher-level frameworks like `@fractary/faber` and can also be used standalone for building custom workflows.
+
+## Features
+
+### Work Tracking
+Unified interface for work item management:
+- ✅ **GitHub Issues** - Fully implemented
+- ⚠️ **Jira Cloud** - Stub only (not functional)
+- ⚠️ **Linear** - Stub only (not functional)
+
+### Repository Management
+Git and repository operations:
+- ✅ **GitHub** - Fully implemented
+- ⚠️ **GitLab** - Stub only (not functional)
+- ⚠️ **Bitbucket** - Stub only (not functional)
+- ✅ **Local Git operations** - Fully implemented
+
+### Specification Management
+Create and manage technical specifications with templates and validation.
+
+### Logging
+Structured logging and session capture for workflow tracking.
+
+### File Storage
+File operations with support for local and cloud storage backends.
+
+### Documentation
+Documentation generation and management utilities.
+
+## Installation
+
+```bash
+npm install @fractary/core
+```
+
+## Usage
+
+### Work Tracking
+
+```typescript
+import { WorkManager } from '@fractary/core/work';
+
+const workManager = new WorkManager({
+  platform: 'github',
+  config: {
+    owner: 'myorg',
+    repo: 'myrepo',
+    token: process.env.GITHUB_TOKEN
+  }
+});
+
+// Create an issue
+const issue = await workManager.createIssue({
+  title: 'Add new feature',
+  description: 'Description of the feature',
+  labels: ['enhancement']
+});
+```
+
+### Repository Management
+
+```typescript
+import { RepoManager } from '@fractary/core/repo';
+
+const repoManager = new RepoManager({
+  platform: 'github',
+  config: {
+    owner: 'myorg',
+    repo: 'myrepo',
+    token: process.env.GITHUB_TOKEN
+  }
+});
+
+// Create a branch
+await repoManager.createBranch({
+  name: 'feature/new-feature',
+  from: 'main'
+});
+
+// Create a pull request
+const pr = await repoManager.createPullRequest({
+  title: 'Add new feature',
+  head: 'feature/new-feature',
+  base: 'main',
+  body: 'PR description'
+});
+```
+
+### Specification Management
+
+```typescript
+import { SpecManager } from '@fractary/core/spec';
+
+const specManager = new SpecManager({
+  rootDir: './specs'
+});
+
+// Create a new spec
+await specManager.createSpec({
+  id: 'SPEC-001',
+  title: 'Authentication System',
+  template: 'technical'
+});
+```
+
+### Logging
+
+```typescript
+import { LogsManager } from '@fractary/core/logs';
+
+const logsManager = new LogsManager({
+  logDir: './logs'
+});
+
+// Start a session
+const sessionId = await logsManager.startSession({
+  name: 'deployment',
+  metadata: { version: '1.0.0' }
+});
+
+// Log events
+await logsManager.log(sessionId, {
+  level: 'info',
+  message: 'Deployment started'
+});
+```
+
+## Module Exports
+
+The package provides the following subpath exports:
+
+- `@fractary/core` - All primitives
+- `@fractary/core/work` - Work tracking only
+- `@fractary/core/repo` - Repository management only
+- `@fractary/core/spec` - Specification management only
+- `@fractary/core/logs` - Logging only
+- `@fractary/core/file` - File storage only
+- `@fractary/core/docs` - Documentation only
+
+## TypeScript Support
+
+This package is written in TypeScript and includes type definitions. TypeScript 5.0+ is recommended.
+
+## Requirements
+
+- Node.js 18.0.0 or higher
+- npm 9.0.0 or higher
+
+## License
+
+MIT
+
+## Contributing
+
+See the [Contributing Guide](../../CONTRIBUTING.md) for details on how to contribute to this project.
+
+## Links
+
+- [GitHub Repository](https://github.com/fractary/core)
+- [Documentation](https://docs.fractary.com/core)
+- [Issue Tracker](https://github.com/fractary/core/issues)

package/dist/__tests__/smoke.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Smoke tests for @fractary/core
+ *
+ * These tests verify basic functionality and module imports.
+ */
+export {};
+//# sourceMappingURL=smoke.test.d.ts.map

package/dist/__tests__/smoke.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/smoke.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/__tests__/smoke.test.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * Smoke tests for @fractary/core
+ *
+ * These tests verify basic functionality and module imports.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const manager_1 = require("../work/manager");
+const manager_2 = require("../repo/manager");
+const manager_3 = require("../spec/manager");
+const manager_4 = require("../logs/manager");
+const manager_5 = require("../file/manager");
+const manager_6 = require("../docs/manager");
+describe('Fractary Core SDK - Smoke Tests', () => {
+    describe('Module Imports', () => {
+        it('should import WorkManager', () => {
+            expect(manager_1.WorkManager).toBeDefined();
+        });
+        it('should import RepoManager', () => {
+            expect(manager_2.RepoManager).toBeDefined();
+        });
+        it('should import SpecManager', () => {
+            expect(manager_3.SpecManager).toBeDefined();
+        });
+        it('should import LogManager', () => {
+            expect(manager_4.LogManager).toBeDefined();
+        });
+        it('should import FileManager', () => {
+            expect(manager_5.FileManager).toBeDefined();
+        });
+        it('should import DocsManager', () => {
+            expect(manager_6.DocsManager).toBeDefined();
+        });
+    });
+    describe('Manager Instantiation', () => {
+        it('should create WorkManager with GitHub config', () => {
+            const config = {
+                platform: 'github',
+                owner: 'test-org',
+                repo: 'test-repo',
+                token: 'test-token',
+            };
+            const manager = new manager_1.WorkManager(config);
+            expect(manager).toBeInstanceOf(manager_1.WorkManager);
+        });
+        it('should create RepoManager with GitHub config', () => {
+            const config = {
+                platform: 'github',
+                owner: 'test-org',
+                repo: 'test-repo',
+                token: 'test-token',
+                defaultBranch: 'main',
+            };
+            const manager = new manager_2.RepoManager(config);
+            expect(manager).toBeInstanceOf(manager_2.RepoManager);
+        });
+        it('should create SpecManager with config', () => {
+            const config = { localPath: '.fractary/specs' };
+            const manager = new manager_3.SpecManager(config);
+            expect(manager).toBeInstanceOf(manager_3.SpecManager);
+        });
+        it('should create LogManager with config', () => {
+            const config = { localPath: '.fractary/logs' };
+            const manager = new manager_4.LogManager(config);
+            expect(manager).toBeInstanceOf(manager_4.LogManager);
+        });
+        it('should create FileManager with config', () => {
+            const config = { basePath: '.fractary/storage' };
+            const manager = new manager_5.FileManager(config);
+            expect(manager).toBeInstanceOf(manager_5.FileManager);
+        });
+        it('should create DocsManager with config', () => {
+            const config = { docsDir: '.fractary/docs' };
+            const manager = new manager_6.DocsManager(config);
+            expect(manager).toBeInstanceOf(manager_6.DocsManager);
+        });
+    });
+    describe('Provider Validation', () => {
+        it('should reject unsupported work platform', () => {
+            const config = {
+                platform: 'unsupported',
+                owner: 'test-org',
+                repo: 'test-repo',
+            };
+            expect(() => new manager_1.WorkManager(config)).toThrow();
+        });
+        it('should reject unsupported repo platform', () => {
+            const config = {
+                platform: 'unsupported',
+                owner: 'test-org',
+                repo: 'test-repo',
+            };
+            expect(() => new manager_2.RepoManager(config)).toThrow();
+        });
+        it('should throw error for Jira provider (not implemented)', () => {
+            const config = {
+                platform: 'jira',
+                host: 'test.atlassian.net',
+                project: 'TEST',
+            };
+            // Jira provider should throw since it's a stub
+            expect(() => new manager_1.WorkManager(config)).toThrow();
+        });
+        it('should throw error for Linear provider (not implemented)', () => {
+            const config = {
+                platform: 'linear',
+                teamId: 'test-team',
+            };
+            // Linear provider should throw since it's a stub
+            expect(() => new manager_1.WorkManager(config)).toThrow();
+        });
+        it('should throw error for GitLab provider (not implemented)', () => {
+            const config = {
+                platform: 'gitlab',
+                owner: 'test-org',
+                repo: 'test-repo',
+            };
+            // GitLab provider should throw since it's a stub
+            expect(() => new manager_2.RepoManager(config)).toThrow();
+        });
+        it('should throw error for Bitbucket provider (not implemented)', () => {
+            const config = {
+                platform: 'bitbucket',
+                owner: 'test-workspace',
+                repo: 'test-repo',
+            };
+            // Bitbucket provider should throw since it's a stub
+            expect(() => new manager_2.RepoManager(config)).toThrow();
+        });
+    });
+});
+//# sourceMappingURL=smoke.test.js.map

package/dist/__tests__/smoke.test.js.map

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

package/dist/common/config.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fractary/core - Configuration Utilities
+ *
+ * Utilities for finding project roots and loading configuration.
+ */
+/**
+ * Find the project root directory by looking for common markers
+ */
+export declare function findProjectRoot(startDir?: string): string;
+/**
+ * Check if a directory is a git repository
+ */
+export declare function isGitRepository(dir?: string): boolean;
+/**
+ * Get the .fractary directory path
+ */
+export declare function getFractaryDir(projectRoot?: string): string;
+/**
+ * Ensure a directory exists
+ */
+export declare function ensureDir(dirPath: string): void;
+/**
+ * Stub config loaders - these return null to indicate no config found
+ * Individual SDKs will use sensible defaults
+ */
+export declare function loadWorkConfig(..._args: unknown[]): null;
+export declare function loadRepoConfig(..._args: unknown[]): null;
+export declare function loadSpecConfig(..._args: unknown[]): null;
+export declare function loadLogConfig(..._args: unknown[]): null;
+//# sourceMappingURL=config.d.ts.map

package/dist/common/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/common/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CA2BxE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAGpE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/C;AAED;;;GAGG;AAGH,wBAAgB,cAAc,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAExD;AAGD,wBAAgB,cAAc,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAExD;AAGD,wBAAgB,cAAc,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAExD;AAGD,wBAAgB,aAAa,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAEvD"}

package/dist/common/config.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * @fractary/core - Configuration Utilities
+ *
+ * Utilities for finding project roots and loading configuration.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findProjectRoot = findProjectRoot;
+exports.isGitRepository = isGitRepository;
+exports.getFractaryDir = getFractaryDir;
+exports.ensureDir = ensureDir;
+exports.loadWorkConfig = loadWorkConfig;
+exports.loadRepoConfig = loadRepoConfig;
+exports.loadSpecConfig = loadSpecConfig;
+exports.loadLogConfig = loadLogConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Find the project root directory by looking for common markers
+ */
+function findProjectRoot(startDir = process.cwd()) {
+    let currentDir = startDir;
+    // Common project root markers
+    const markers = [
+        'package.json',
+        '.git',
+        'tsconfig.json',
+        'pyproject.toml',
+        'setup.py',
+    ];
+    while (currentDir !== path.parse(currentDir).root) {
+        // Check if any marker exists in current directory
+        for (const marker of markers) {
+            const markerPath = path.join(currentDir, marker);
+            if (fs.existsSync(markerPath)) {
+                return currentDir;
+            }
+        }
+        // Move up one directory
+        currentDir = path.dirname(currentDir);
+    }
+    // If no marker found, return the starting directory
+    return startDir;
+}
+/**
+ * Check if a directory is a git repository
+ */
+function isGitRepository(dir = process.cwd()) {
+    const gitDir = path.join(dir, '.git');
+    return fs.existsSync(gitDir);
+}
+/**
+ * Get the .fractary directory path
+ */
+function getFractaryDir(projectRoot) {
+    const root = projectRoot || findProjectRoot();
+    return path.join(root, '.fractary');
+}
+/**
+ * Ensure a directory exists
+ */
+function ensureDir(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+}
+/**
+ * Stub config loaders - these return null to indicate no config found
+ * Individual SDKs will use sensible defaults
+ */
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+function loadWorkConfig(..._args) {
+    return null;
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+function loadRepoConfig(..._args) {
+    return null;
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+function loadSpecConfig(..._args) {
+    return null;
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+function loadLogConfig(..._args) {
+    return null;
+}
+//# sourceMappingURL=config.js.map

package/dist/common/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/common/config.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQH,0CA2BC;AAKD,0CAGC;AAKD,wCAGC;AAKD,8BAIC;AAQD,wCAEC;AAGD,wCAEC;AAGD,wCAEC;AAGD,sCAEC;AAnFD,uCAAyB;AACzB,2CAA6B;AAE7B;;GAEG;AACH,SAAgB,eAAe,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAC9D,IAAI,UAAU,GAAG,QAAQ,CAAC;IAE1B,8BAA8B;IAC9B,MAAM,OAAO,GAAG;QACd,cAAc;QACd,MAAM;QACN,eAAe;QACf,gBAAgB;QAChB,UAAU;KACX,CAAC;IAEF,OAAO,UAAU,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,kDAAkD;QAClD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9B,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,oDAAoD;IACpD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACtC,OAAO,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,WAAoB;IACjD,MAAM,IAAI,GAAG,WAAW,IAAI,eAAe,EAAE,CAAC;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,OAAe;IACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;;GAGG;AAEH,6DAA6D;AAC7D,SAAgB,cAAc,CAAC,GAAG,KAAgB;IAChD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6DAA6D;AAC7D,SAAgB,cAAc,CAAC,GAAG,KAAgB;IAChD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6DAA6D;AAC7D,SAAgB,cAAc,CAAC,GAAG,KAAgB;IAChD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6DAA6D;AAC7D,SAAgB,aAAa,CAAC,GAAG,KAAgB;IAC/C,OAAO,IAAI,CAAC;AACd,CAAC"}