@crafter/cli-tree 0.1.0

package/dist/flow/encode.d.ts

@@ -0,0 +1,5 @@
+import type { Workflow, FlowRenderOptions } from "./types";
+export declare function flowToAnsi(workflow: Workflow, opts?: FlowRenderOptions): string;
+export declare function flowToString(workflow: Workflow, opts?: FlowRenderOptions): string;
+export declare function flowToHtml(workflow: Workflow, opts?: FlowRenderOptions): string;
+export declare function printFlow(workflow: Workflow, opts?: FlowRenderOptions): void;

package/dist/flow/index.d.ts

@@ -0,0 +1,8 @@
+export { parseWorkflow } from "./parse";
+export { parseYaml } from "./yaml";
+export { validateWorkflow } from "./validate";
+export { computeLayout } from "./layout";
+export { renderFlow } from "./render";
+export { flowToAnsi, flowToString, flowToHtml, printFlow } from "./encode";
+export type { Workflow, WorkflowNode, WorkflowEdge, FlowRenderOptions, ValidationError, ValidationResult, } from "./types";
+export type { Layout, LayoutNode, LayoutEdge, LayoutOptions } from "./layout";

package/dist/flow/index.js

@@ -0,0 +1,25 @@
+import {
+  computeLayout,
+  flowToAnsi,
+  flowToHtml,
+  flowToString,
+  parseWorkflow,
+  parseYaml,
+  printFlow,
+  renderFlow,
+  validateWorkflow
+} from "../chunk-pkfpaae1.js";
+import"../chunk-q4se2rwe.js";
+export {
+  validateWorkflow,
+  renderFlow,
+  printFlow,
+  parseYaml,
+  parseWorkflow,
+  flowToString,
+  flowToHtml,
+  flowToAnsi,
+  computeLayout
+};
+
+//# debugId=7C2AF30429458F1A64756E2164756E21

package/dist/flow/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "7C2AF30429458F1A64756E2164756E21",
+  "names": []
+}

package/dist/flow/layout.d.ts

@@ -0,0 +1,30 @@
+import type { Workflow, WorkflowNode, WorkflowEdge } from "./types";
+export interface LayoutNode {
+    id: string;
+    node: WorkflowNode;
+    col: number;
+    row: number;
+    width: number;
+    height: number;
+    x: number;
+    y: number;
+}
+export interface LayoutEdge {
+    from: string;
+    to: string;
+    edge: WorkflowEdge;
+}
+export interface Layout {
+    nodes: LayoutNode[];
+    edges: LayoutEdge[];
+    totalWidth: number;
+    totalHeight: number;
+}
+export interface LayoutOptions {
+    boxPaddingX?: number;
+    colGap?: number;
+    rowGap?: number;
+    minBoxWidth?: number;
+}
+export declare function computeLayout(workflow: Workflow, opts?: LayoutOptions): Layout;
+export declare function findNode(layout: Layout, id: string): LayoutNode | undefined;

package/dist/flow/parse.d.ts

@@ -0,0 +1,2 @@
+import type { Workflow } from "./types";
+export declare function parseWorkflow(yamlText: string): Workflow;

package/dist/flow/render.d.ts

@@ -0,0 +1,3 @@
+import { type Grid } from "../grid";
+import type { Workflow, FlowRenderOptions } from "./types";
+export declare function renderFlow(workflow: Workflow, opts?: FlowRenderOptions): Grid;

package/dist/flow/types.d.ts

@@ -0,0 +1,42 @@
+import type { CLINode } from "../types";
+export interface Workflow {
+    name: string;
+    description?: string;
+    cli: string;
+    version?: string;
+    nodes: WorkflowNode[];
+    edges: WorkflowEdge[];
+}
+export interface WorkflowNode {
+    id: string;
+    command: string[];
+    label?: string;
+    description?: string;
+    optional?: boolean;
+    ref?: CLINode;
+}
+export interface WorkflowEdge {
+    from: string;
+    to: string;
+    condition?: string;
+    label?: string;
+}
+export interface FlowRenderOptions {
+    color?: boolean;
+    showDescriptions?: boolean;
+    showCommands?: boolean;
+    compact?: boolean;
+}
+export interface ValidationError {
+    node?: string;
+    edge?: {
+        from: string;
+        to: string;
+    };
+    message: string;
+    severity: "error" | "warning";
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}

package/dist/flow/validate.d.ts

@@ -0,0 +1,3 @@
+import type { CLINode } from "../types";
+import type { Workflow, ValidationResult } from "./types";
+export declare function validateWorkflow(workflow: Workflow, tree?: CLINode): ValidationResult;

package/dist/flow/yaml.d.ts

@@ -0,0 +1,4 @@
+export type YamlValue = string | number | boolean | null | YamlValue[] | {
+    [key: string]: YamlValue;
+};
+export declare function parseYaml(text: string): YamlValue;

package/dist/grid.d.ts

@@ -0,0 +1,14 @@
+export interface Cell {
+    char: string;
+    fg: string | null;
+}
+export interface Grid {
+    width: number;
+    height: number;
+    cells: Cell[][];
+    set(x: number, y: number, char: string, fg?: string | null): void;
+    get(x: number, y: number): Cell | undefined;
+    addRow(): void;
+}
+export declare function createGrid(width: number): Grid;
+export declare function writeText(grid: Grid, x: number, y: number, text: string, fg?: string | null): number;

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import type { CLINode, Flag, Arg, TreeOptions, AnsiColor } from "./types";
+export type { CLINode, Flag, Arg, TreeOptions, AnsiColor };
+export { parseHelp, parseHelpRecursive } from "./parse";
+export declare function treeToAnsi(root: CLINode, opts?: TreeOptions): string;
+export declare function treeToString(root: CLINode, opts?: TreeOptions): string;
+export declare function treeToHtml(root: CLINode, opts?: TreeOptions): string;
+export declare function printTree(root: CLINode, opts?: TreeOptions): void;

package/dist/index.js

@@ -0,0 +1,21 @@
+import {
+  printTree,
+  treeToAnsi,
+  treeToHtml,
+  treeToString
+} from "./chunk-v5w3w6bd.js";
+import {
+  parseHelp,
+  parseHelpRecursive
+} from "./chunk-5aahbfr2.js";
+import"./chunk-q4se2rwe.js";
+export {
+  treeToString,
+  treeToHtml,
+  treeToAnsi,
+  printTree,
+  parseHelpRecursive,
+  parseHelp
+};
+
+//# debugId=A7CFDE292CCE9BF364756E2164756E21

package/dist/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "A7CFDE292CCE9BF364756E2164756E21",
+  "names": []
+}

package/dist/miner/history.d.ts

@@ -0,0 +1,6 @@
+import type { HistoryEntry } from "./types";
+export declare function readHistoryFile(path: string): Promise<string>;
+export declare function detectHistoryFormat(text: string): "zsh-extended" | "bash" | "fish" | "unknown";
+export declare function parseHistory(text: string): HistoryEntry[];
+export declare function tokenize(cmd: string): string[];
+export declare function defaultHistoryPath(): string | null;

package/dist/miner/index.d.ts

@@ -0,0 +1,18 @@
+import { parseHistory, readHistoryFile, defaultHistoryPath, tokenize, detectHistoryFormat } from "./history";
+import { segmentSessions, filterByCli } from "./sessions";
+import { buildTransitions, normalizeTransitions, extractSubcommand, extractSubcommandPath } from "./transitions";
+import { extractPaths, clusterIntoWorkflows } from "./workflows";
+import { computeStats } from "./stats";
+import { suggestSkills, type SkillSuggestion } from "./suggest";
+import type { HistoryEntry, Session, Transition, MinedWorkflow, CliUsageStats, MineOptions } from "./types";
+export type { HistoryEntry, Session, Transition, MinedWorkflow, CliUsageStats, MineOptions, SkillSuggestion };
+export { parseHistory, readHistoryFile, defaultHistoryPath, tokenize, detectHistoryFormat, segmentSessions, filterByCli, buildTransitions, normalizeTransitions, extractSubcommand, extractSubcommandPath, extractPaths, clusterIntoWorkflows, computeStats, suggestSkills, };
+export interface MineResult {
+    cli: string;
+    stats: CliUsageStats;
+    transitions: Transition[];
+    workflows: MinedWorkflow[];
+    suggestions: SkillSuggestion[];
+    sessionsAnalyzed: number;
+}
+export declare function mineCli(cli: string, options?: MineOptions): Promise<MineResult>;

package/dist/miner/index.js

@@ -0,0 +1,38 @@
+import {
+  buildTransitions,
+  clusterIntoWorkflows,
+  computeStats,
+  defaultHistoryPath,
+  detectHistoryFormat,
+  extractPaths,
+  extractSubcommand,
+  extractSubcommandPath,
+  filterByCli,
+  mineCli,
+  normalizeTransitions,
+  parseHistory,
+  readHistoryFile,
+  segmentSessions,
+  suggestSkills,
+  tokenize
+} from "../chunk-57gtsvhb.js";
+export {
+  tokenize,
+  suggestSkills,
+  segmentSessions,
+  readHistoryFile,
+  parseHistory,
+  normalizeTransitions,
+  mineCli,
+  filterByCli,
+  extractSubcommandPath,
+  extractSubcommand,
+  extractPaths,
+  detectHistoryFormat,
+  defaultHistoryPath,
+  computeStats,
+  clusterIntoWorkflows,
+  buildTransitions
+};
+
+//# debugId=79FF1A9AE05DD20F64756E2164756E21

package/dist/miner/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "79FF1A9AE05DD20F64756E2164756E21",
+  "names": []
+}

package/dist/miner/sessions.d.ts

@@ -0,0 +1,3 @@
+import type { HistoryEntry, Session } from "./types";
+export declare function segmentSessions(entries: HistoryEntry[], gapMinutes?: number): Session[];
+export declare function filterByCli(sessions: Session[], cli: string): Session[];

package/dist/miner/stats.d.ts

@@ -0,0 +1,2 @@
+import type { HistoryEntry, CliUsageStats, Session } from "./types";
+export declare function computeStats(entries: HistoryEntry[], sessions: Session[], cli: string): CliUsageStats;

package/dist/miner/suggest.d.ts

@@ -0,0 +1,11 @@
+import type { MinedWorkflow, CliUsageStats } from "./types";
+export interface SkillSuggestion {
+    name: string;
+    description: string;
+    cli: string;
+    commands: string[];
+    frequency: number;
+    reason: string;
+    priority: "high" | "medium" | "low";
+}
+export declare function suggestSkills(workflows: MinedWorkflow[], stats: CliUsageStats): SkillSuggestion[];

package/dist/miner/transitions.d.ts

@@ -0,0 +1,6 @@
+import type { Session, Transition, HistoryEntry } from "./types";
+export declare function extractSubcommand(entry: HistoryEntry): string;
+export declare function extractSubcommandPath(entry: HistoryEntry, maxDepth?: number): string[];
+export declare function buildTransitions(sessions: Session[]): Map<string, Map<string, number>>;
+export declare function normalizeTransitions(raw: Map<string, Map<string, number>>, minSupport?: number, minConfidence?: number): Transition[];
+export declare function topTransitions(transitions: Transition[], n?: number): Transition[];

package/dist/miner/types.d.ts

@@ -0,0 +1,46 @@
+export interface HistoryEntry {
+    timestamp: number;
+    raw: string;
+    argv: string[];
+}
+export interface Session {
+    start: number;
+    end: number;
+    entries: HistoryEntry[];
+}
+export interface Transition {
+    from: string;
+    to: string;
+    count: number;
+    confidence: number;
+}
+export interface MinedWorkflow {
+    name: string;
+    cli: string;
+    path: string[][];
+    support: number;
+    confidence: number;
+    source: "history" | "llm" | "makefile";
+}
+export interface CliUsageStats {
+    cli: string;
+    totalInvocations: number;
+    uniqueSubcommands: number;
+    topSubcommands: Array<{
+        subcommand: string;
+        count: number;
+    }>;
+    topFlags: Array<{
+        flag: string;
+        count: number;
+    }>;
+    sessionCount: number;
+}
+export interface MineOptions {
+    sessionGapMinutes?: number;
+    minSupport?: number;
+    minConfidence?: number;
+    minPathLength?: number;
+    maxPathLength?: number;
+    historyPath?: string;
+}

package/dist/miner/workflows.d.ts

@@ -0,0 +1,11 @@
+import type { Session, MinedWorkflow } from "./types";
+export interface PathCluster {
+    signature: string;
+    path: string[];
+    occurrences: number;
+}
+export declare function extractPaths(sessions: Session[], minLength?: number, maxLength?: number): PathCluster[];
+export declare function clusterIntoWorkflows(clusters: PathCluster[], cli: string, options?: {
+    minSupport?: number;
+    topK?: number;
+}): MinedWorkflow[];

package/dist/parse.d.ts

@@ -0,0 +1,3 @@
+import type { CLINode } from "./types";
+export declare function parseHelp(name: string, helpText: string): CLINode;
+export declare function parseHelpRecursive(binary: string, args?: string[], maxDepth?: number, depth?: number): Promise<CLINode>;

package/dist/render.d.ts

@@ -0,0 +1,3 @@
+import type { Grid } from "./grid";
+import type { CLINode, TreeOptions } from "./types";
+export declare function renderTree(root: CLINode, opts?: TreeOptions): Grid;

package/dist/types.d.ts

@@ -0,0 +1,39 @@
+export type AnsiColor = "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white" | "gray";
+export declare const ANSI_COLORS: Record<AnsiColor, string>;
+export declare const ANSI_RESET = "\u001B[0m";
+export declare const ANSI_BOLD = "\u001B[1m";
+export declare const ANSI_DIM = "\u001B[2m";
+export interface CLINode {
+    name: string;
+    description?: string;
+    aliases?: string[];
+    subcommands?: CLINode[];
+    flags?: Flag[];
+    args?: Arg[];
+}
+export interface Flag {
+    name: string;
+    short?: string;
+    type: "boolean" | "string" | "number" | "enum";
+    enum?: string[];
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+}
+export interface Arg {
+    name: string;
+    required?: boolean;
+    variadic?: boolean;
+    description?: string;
+}
+export interface TreeOptions {
+    color?: boolean;
+    indent?: number;
+    showFlags?: boolean;
+    showArgs?: boolean;
+    showDescriptions?: boolean;
+    showTypes?: boolean;
+    showDefaults?: boolean;
+    maxDepth?: number;
+    compact?: boolean;
+}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@crafter/cli-tree",
+  "version": "0.1.0",
+  "description": "Explore and map any CLI tool deeply. Parse --help trees, mine shell history for repeated workflows, surface hidden flags via LLM archaeology, and suggest new agent skills from your usage patterns.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./miner": {
+      "bun": "./src/miner/index.ts",
+      "import": "./dist/miner/index.js",
+      "types": "./dist/miner/index.d.ts"
+    },
+    "./archaeology": {
+      "bun": "./src/archaeology/index.ts",
+      "import": "./dist/archaeology/index.js",
+      "types": "./dist/archaeology/index.d.ts"
+    },
+    "./flow": {
+      "bun": "./src/flow/index.ts",
+      "import": "./dist/flow/index.js",
+      "types": "./dist/flow/index.d.ts"
+    }
+  },
+  "bin": {
+    "clitree": "./dist/cli.js",
+    "cli-tree": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "skill",
+    "workflows",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "bun run build.ts",
+    "test": "bun test",
+    "check": "bunx --bun @biomejs/biome check --write .",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "cli",
+    "tree",
+    "terminal",
+    "command",
+    "visualizer",
+    "flags",
+    "ascii",
+    "tui",
+    "shell-history",
+    "archaeology",
+    "skill",
+    "claude-code",
+    "workflow",
+    "automation"
+  ],
+  "author": "Crafter Station",
+  "license": "MIT",
+  "homepage": "https://github.com/crafter-station/cli-tree",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/crafter-station/cli-tree.git"
+  },
+  "bugs": {
+    "url": "https://github.com/crafter-station/cli-tree/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.0.0",
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}