@fractary/core-cli 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,313 @@
+# @fractary/core-cli
+
+Command-line interface for Fractary Core SDK - work tracking, repository management, specifications, logging, file storage, and documentation.
+
+## Installation
+
+```bash
+npm install -g @fractary/core-cli
+```
+
+## Usage
+
+The CLI provides six main command categories:
+
+```bash
+fractary-core <command> [subcommand] [options]
+```
+
+### Work Tracking
+
+Manage work items, issues, and project tasks:
+
+```bash
+# Fetch an issue
+fractary-core work issue fetch 123
+
+# Create a new issue
+fractary-core work issue create --title "Add feature" --body "Description"
+
+# Search issues
+fractary-core work issue search --query "bug" --state open
+
+# Add comment
+fractary-core work comment create 123 --body "Fixed in PR #456"
+
+# Manage labels
+fractary-core work label add 123 --labels "bug,urgent"
+
+# Initialize work tracking
+fractary-core work init --platform github
+```
+
+### Repository Operations
+
+Manage Git repositories, branches, commits, and pull requests:
+
+```bash
+# Create a branch
+fractary-core repo branch create feature/new-feature
+
+# Commit with conventional commits
+fractary-core repo commit --message "Add login" --type feat --scope auth
+
+# Create pull request
+fractary-core repo pr create --title "Add feature" --body "Description"
+
+# Manage tags
+fractary-core repo tag create v1.0.0 --message "Release 1.0.0"
+
+# Work with worktrees
+fractary-core repo worktree create feature-branch
+
+# Check status
+fractary-core repo status
+```
+
+### Specification Management
+
+Create and manage technical specifications:
+
+```bash
+# Create specification
+fractary-core spec create "User Authentication" --template feature
+
+# Validate specification
+fractary-core spec validate SPEC-20241216
+
+# List specifications
+fractary-core spec list --status validated
+
+# Generate refinement questions
+fractary-core spec refine SPEC-20241216
+```
+
+### Log Management
+
+Capture and manage operational logs:
+
+```bash
+# Start session capture
+fractary-core logs capture 123 --model claude-3.5-sonnet
+
+# Write log entry
+fractary-core logs write --type build --title "Build" --content "Success"
+
+# Search logs
+fractary-core logs search --query "error" --type session
+
+# Archive old logs
+fractary-core logs archive --max-age 90
+```
+
+### File Storage
+
+Manage file storage operations:
+
+```bash
+# Write file
+fractary-core file write data.json --content '{"key":"value"}'
+
+# Read file
+fractary-core file read data.json
+
+# List files
+fractary-core file list --prefix "data/"
+
+# Copy file
+fractary-core file copy source.txt destination.txt
+```
+
+### Documentation Management
+
+Create and manage documentation:
+
+```bash
+# Create document
+fractary-core docs create guide-001 \
+  --title "User Guide" \
+  --content "..." \
+  --format markdown \
+  --tags "guide,user"
+
+# Search documents
+fractary-core docs search --text "authentication" --tags "api"
+
+# List documents
+fractary-core docs list --category "guides"
+```
+
+## Configuration
+
+The CLI uses configuration files stored in `.fractary/core/config.json`:
+
+```json
+{
+  "work": {
+    "platform": "github",
+    "repository": {
+      "owner": "fractary",
+      "name": "core"
+    }
+  },
+  "repo": {
+    "platform": "github"
+  }
+}
+```
+
+Initialize configuration for each plugin:
+
+```bash
+fractary-core work init --platform github
+```
+
+## JSON Output
+
+All commands support `--json` flag for machine-readable output:
+
+```bash
+fractary-core work issue fetch 123 --json
+```
+
+Output format:
+
+```json
+{
+  "status": "success",
+  "data": {
+    "number": 123,
+    "title": "Issue title",
+    "state": "open"
+  }
+}
+```
+
+## Programmatic Usage
+
+Import and use CLI components programmatically:
+
+```typescript
+import { getWorkManager, createWorkCommand } from '@fractary/core-cli';
+
+// Use SDK managers directly
+const workManager = await getWorkManager();
+const issue = await workManager.fetchIssue(123);
+
+// Or compose custom CLI tools
+import { Command } from 'commander';
+
+const program = new Command();
+program.addCommand(createWorkCommand());
+program.parse();
+```
+
+## Command Reference
+
+### Work Commands
+
+- `work issue fetch <number>` - Fetch issue details
+- `work issue create` - Create new issue
+- `work issue update <number>` - Update issue
+- `work issue close <number>` - Close issue
+- `work issue reopen <number>` - Reopen issue
+- `work issue assign <number>` - Assign/unassign issue
+- `work issue classify <number>` - Classify work type
+- `work issue search` - Search issues
+- `work comment create <number>` - Add comment
+- `work comment list <number>` - List comments
+- `work label add <number>` - Add labels
+- `work label remove <number>` - Remove labels
+- `work label list` - List all labels
+- `work milestone create` - Create milestone
+- `work milestone list` - List milestones
+- `work milestone set <number>` - Set milestone
+- `work init` - Initialize work tracking
+
+### Repo Commands
+
+- `repo branch create <name>` - Create branch
+- `repo branch delete <name>` - Delete branch
+- `repo branch list` - List branches
+- `repo commit` - Create commit
+- `repo pr create` - Create pull request
+- `repo pr list` - List pull requests
+- `repo pr merge <number>` - Merge pull request
+- `repo pr review <number>` - Review pull request
+- `repo tag create <name>` - Create tag
+- `repo tag push <name>` - Push tag
+- `repo tag list` - List tags
+- `repo worktree create <branch>` - Create worktree
+- `repo worktree list` - List worktrees
+- `repo worktree remove <path>` - Remove worktree
+- `repo worktree cleanup` - Clean up worktrees
+- `repo status` - Show status
+- `repo push` - Push to remote
+- `repo pull` - Pull from remote
+
+### Spec Commands
+
+- `spec create <title>` - Create specification
+- `spec get <id>` - Get specification
+- `spec list` - List specifications
+- `spec update <id>` - Update specification
+- `spec validate <id>` - Validate specification
+- `spec refine <id>` - Generate refinement questions
+- `spec delete <id>` - Delete specification
+- `spec templates` - List templates
+
+### Logs Commands
+
+- `logs capture <issue>` - Start session capture
+- `logs stop` - Stop capture
+- `logs write` - Write log entry
+- `logs read <id>` - Read log entry
+- `logs search` - Search logs
+- `logs list` - List logs
+- `logs archive` - Archive logs
+- `logs delete <id>` - Delete log
+
+### File Commands
+
+- `file write <path>` - Write file
+- `file read <path>` - Read file
+- `file exists <path>` - Check existence
+- `file list` - List files
+- `file delete <path>` - Delete file
+- `file copy <source> <dest>` - Copy file
+- `file move <source> <dest>` - Move file
+
+### Docs Commands
+
+- `docs create <id>` - Create document
+- `docs get <id>` - Get document
+- `docs list` - List documents
+- `docs update <id>` - Update document
+- `docs delete <id>` - Delete document
+- `docs search` - Search documents
+
+## Platform Support
+
+### Work Tracking
+- **GitHub Issues** - Full support
+- **Jira Cloud** - Basic support
+- **Linear** - Basic support
+
+### Repository Management
+- **GitHub** - Full support
+- **GitLab** - Planned
+- **Bitbucket** - Planned
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Git (for repository operations)
+
+## License
+
+MIT
+
+## Related Projects
+
+- [@fractary/core](../sdk/js) - Core SDK for JavaScript/TypeScript
+- [fractary/core](../) - Fractary Core monorepo

package/dist/cli.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Fractary Core CLI - Command-line interface for core operations
+ *
+ * Binary entry point for `fractary-core` command
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Fractary Core CLI - Command-line interface for core operations
+ *
+ * Binary entry point for `fractary-core` command
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const work_1 = require("./commands/work");
+const repo_1 = require("./commands/repo");
+const spec_1 = require("./commands/spec");
+const logs_1 = require("./commands/logs");
+const file_1 = require("./commands/file");
+const docs_1 = require("./commands/docs");
+// Package information
+const packageJson = require('../package.json');
+// Create main program
+const program = new commander_1.Command();
+program
+    .name('fractary-core')
+    .description('CLI for Fractary Core SDK - work, repo, spec, logs, file, docs')
+    .version(packageJson.version);
+// Add all command trees
+program.addCommand((0, work_1.createWorkCommand)());
+program.addCommand((0, repo_1.createRepoCommand)());
+program.addCommand((0, spec_1.createSpecCommand)());
+program.addCommand((0, logs_1.createLogsCommand)());
+program.addCommand((0, file_1.createFileCommand)());
+program.addCommand((0, docs_1.createDocsCommand)());
+// Custom help text
+program.addHelpText('after', `
+${chalk_1.default.bold('Commands:')}
+  work        Work item tracking (issues, comments, labels, milestones)
+  repo        Repository operations (branches, commits, PRs, tags, worktrees)
+  spec        Specification management (create, validate, refine)
+  logs        Log management (capture, search, archive)
+  file        File storage operations (read, write, list, delete)
+  docs        Documentation management (create, search, export)
+
+${chalk_1.default.bold('Examples:')}
+  $ fractary-core work issue fetch 123
+  $ fractary-core repo commit --message "Add feature" --type feat
+  $ fractary-core spec validate SPEC-20241216
+  $ fractary-core logs search --query "error" --type session
+  $ fractary-core file write data.json --content '{"key":"value"}'
+  $ fractary-core docs create guide-001 --title "User Guide" --content "..."
+
+${chalk_1.default.bold('Documentation:')}
+  Run ${chalk_1.default.cyan('fractary-core <command> --help')} for more information on a command.
+`);
+// Show help if no command specified
+if (process.argv.length === 2) {
+    program.outputHelp();
+    process.exit(0);
+}
+// Error handling
+program.exitOverride();
+async function main() {
+    try {
+        await program.parseAsync(process.argv);
+    }
+    catch (error) {
+        if (error.code === 'commander.help') {
+            process.exit(0);
+        }
+        if (error.code === 'commander.unknownCommand') {
+            console.error(chalk_1.default.red('Unknown command:'), error.message);
+            console.log(chalk_1.default.gray('\nAvailable commands: work, repo, spec, logs, file, docs'));
+            console.log(chalk_1.default.gray('Run "fractary-core --help" for more information.'));
+            process.exit(1);
+        }
+        console.error(chalk_1.default.red('Error:'), error.message);
+        process.exit(1);
+    }
+}
+// Run CLI
+main().catch((error) => {
+    console.error(chalk_1.default.red('Fatal error:'), error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AAEA;;;;GAIG;;;;;AAEH,yCAAoC;AACpC,kDAA0B;AAC1B,0CAAoD;AACpD,0CAAoD;AACpD,0CAAoD;AACpD,0CAAoD;AACpD,0CAAoD;AACpD,0CAAoD;AAEpD,sBAAsB;AACtB,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE/C,sBAAsB;AACtB,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,gEAAgE,CAAC;KAC7E,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AAEhC,wBAAwB;AACxB,OAAO,CAAC,UAAU,CAAC,IAAA,wBAAiB,GAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,IAAA,wBAAiB,GAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,IAAA,wBAAiB,GAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,IAAA,wBAAiB,GAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,IAAA,wBAAiB,GAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,IAAA,wBAAiB,GAAE,CAAC,CAAC;AAExC,mBAAmB;AACnB,OAAO,CAAC,WAAW,CACjB,OAAO,EACP;EACA,eAAK,CAAC,IAAI,CAAC,WAAW,CAAC;;;;;;;;EAQvB,eAAK,CAAC,IAAI,CAAC,WAAW,CAAC;;;;;;;;EAQvB,eAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC;QACtB,eAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC;CACnD,CACA,CAAC;AAEF,oCAAoC;AACpC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IAC9B,OAAO,CAAC,UAAU,EAAE,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,iBAAiB;AACjB,OAAO,CAAC,YAAY,EAAE,CAAC;AAEvB,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,0BAA0B,EAAE,CAAC;YAC9C,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5D,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,IAAI,CAAC,0DAA0D,CAAC,CACvE,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC,CAAC;YAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,UAAU;AACV,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/commands/docs/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Docs subcommand - Documentation management
+ *
+ * Provides documentation operations via @fractary/core DocsManager.
+ */
+import { Command } from 'commander';
+/**
+ * Create the docs command tree
+ */
+export declare function createDocsCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/docs/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAW3C"}