@harness-engineering/cli 1.3.0 → 1.6.0

package/dist/{create-skill-4GKJZB5R.js → create-skill-NZDLMMR6.js}

@@ -1,7 +1,7 @@
 import {
   createCreateSkillCommand,
   generateSkillFiles
-} from "./chunk-EFZOLZFB.js";
+} from "./chunk-ACMDUQJG.js";
 export {
   createCreateSkillCommand,
   generateSkillFiles

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { Command } from 'commander';
+import { ContextQLResult, IngestResult } from '@harness-engineering/graph';
 import { Result } from '@harness-engineering/core';
 import { z } from 'zod';
 
@@ -18,6 +19,37 @@ interface PreambleOptions {
 }
 declare function buildPreamble(options: PreambleOptions): string;
 
+declare function runScan(projectPath: string): Promise<{
+    nodeCount: number;
+    edgeCount: number;
+    durationMs: number;
+}>;
+
+declare function runQuery(projectPath: string, rootNodeId: string, opts: {
+    depth?: number;
+    types?: string;
+    edges?: string;
+    bidirectional?: boolean;
+}): Promise<ContextQLResult>;
+
+declare function runIngest(projectPath: string, source: string, opts?: {
+    full?: boolean;
+    all?: boolean;
+}): Promise<IngestResult>;
+
+interface GraphStatusResult {
+    status: string;
+    message?: string;
+    nodeCount?: number;
+    edgeCount?: number;
+    nodesByType?: Record<string, number>;
+    lastScanTimestamp?: string;
+    connectorSyncStatus?: Record<string, string>;
+}
+declare function runGraphStatus(projectPath: string): Promise<GraphStatusResult>;
+
+declare function runGraphExport(projectPath: string, format: string): Promise<string>;
+
 /**
  * CLI Exit Codes
  */
@@ -91,6 +123,7 @@ type Platform = 'claude-code' | 'gemini-cli';
 interface GenerateOptions {
     platforms: Platform[];
     global: boolean;
+    includeGlobal: boolean;
     output?: string;
     skillsDir: string;
     dryRun: boolean;
@@ -107,6 +140,11 @@ interface GenerateResult {
 }
 declare function generateSlashCommands(opts: GenerateOptions): GenerateResult[];
 
+interface SkillSource {
+    dir: string;
+    source: 'project' | 'global';
+}
+
 declare const OutputMode: {
     readonly JSON: "json";
     readonly TEXT: "text";
@@ -431,151 +469,153 @@ declare class TemplateEngine {
     private mergeFileLists;
 }
 
-declare const PersonaSchema: z.ZodObject<{
-    version: z.ZodLiteral<1>;
-    name: z.ZodString;
-    description: z.ZodString;
-    role: z.ZodString;
-    skills: z.ZodArray<z.ZodString, "many">;
-    commands: z.ZodArray<z.ZodString, "many">;
-    triggers: z.ZodArray<z.ZodDiscriminatedUnion<"event", [z.ZodObject<{
-        event: z.ZodLiteral<"on_pr">;
-        conditions: z.ZodOptional<z.ZodObject<{
-            paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, "strip", z.ZodTypeAny, {
-            paths?: string[] | undefined;
-        }, {
-            paths?: string[] | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        event: "on_pr";
-        conditions?: {
-            paths?: string[] | undefined;
-        } | undefined;
-    }, {
-        event: "on_pr";
-        conditions?: {
-            paths?: string[] | undefined;
-        } | undefined;
-    }>, z.ZodObject<{
-        event: z.ZodLiteral<"on_commit">;
-        conditions: z.ZodOptional<z.ZodObject<{
-            branches: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, "strip", z.ZodTypeAny, {
-            branches?: string[] | undefined;
-        }, {
-            branches?: string[] | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        event: "on_commit";
-        conditions?: {
-            branches?: string[] | undefined;
-        } | undefined;
-    }, {
-        event: "on_commit";
-        conditions?: {
-            branches?: string[] | undefined;
-        } | undefined;
-    }>, z.ZodObject<{
-        event: z.ZodLiteral<"scheduled">;
-        cron: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        event: "scheduled";
-        cron: string;
-    }, {
-        event: "scheduled";
-        cron: string;
-    }>]>, "many">;
-    config: z.ZodDefault<z.ZodObject<{
-        severity: z.ZodDefault<z.ZodEnum<["error", "warning"]>>;
-        autoFix: z.ZodDefault<z.ZodBoolean>;
-        timeout: z.ZodDefault<z.ZodNumber>;
+declare const TriggerContextSchema: z.ZodDefault<z.ZodEnum<["always", "on_pr", "on_commit", "on_review", "scheduled", "manual", "on_plan_approved"]>>;
+type TriggerContext = z.infer<typeof TriggerContextSchema>;
+declare const CommandStepSchema: z.ZodObject<{
+    command: z.ZodString;
+    when: z.ZodDefault<z.ZodEnum<["always", "on_pr", "on_commit", "on_review", "scheduled", "manual", "on_plan_approved"]>>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    when: "always" | "on_pr" | "on_commit" | "on_review" | "scheduled" | "manual" | "on_plan_approved";
+}, {
+    command: string;
+    when?: "always" | "on_pr" | "on_commit" | "on_review" | "scheduled" | "manual" | "on_plan_approved" | undefined;
+}>;
+declare const SkillStepSchema: z.ZodObject<{
+    skill: z.ZodString;
+    when: z.ZodDefault<z.ZodEnum<["always", "on_pr", "on_commit", "on_review", "scheduled", "manual", "on_plan_approved"]>>;
+    output: z.ZodDefault<z.ZodEnum<["inline", "artifact", "auto"]>>;
+}, "strip", z.ZodTypeAny, {
+    when: "always" | "on_pr" | "on_commit" | "on_review" | "scheduled" | "manual" | "on_plan_approved";
+    skill: string;
+    output: "inline" | "artifact" | "auto";
+}, {
+    skill: string;
+    when?: "always" | "on_pr" | "on_commit" | "on_review" | "scheduled" | "manual" | "on_plan_approved" | undefined;
+    output?: "inline" | "artifact" | "auto" | undefined;
+}>;
+declare const StepSchema: z.ZodUnion<[z.ZodObject<{
+    command: z.ZodString;
+    when: z.ZodDefault<z.ZodEnum<["always", "on_pr", "on_commit", "on_review", "scheduled", "manual", "on_plan_approved"]>>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    when: "always" | "on_pr" | "on_commit" | "on_review" | "scheduled" | "manual" | "on_plan_approved";
+}, {
+    command: string;
+    when?: "always" | "on_pr" | "on_commit" | "on_review" | "scheduled" | "manual" | "on_plan_approved" | undefined;
+}>, z.ZodObject<{
+    skill: z.ZodString;
+    when: z.ZodDefault<z.ZodEnum<["always", "on_pr", "on_commit", "on_review", "scheduled", "manual", "on_plan_approved"]>>;
+    output: z.ZodDefault<z.ZodEnum<["inline", "artifact", "auto"]>>;
+}, "strip", z.ZodTypeAny, {
+    when: "always" | "on_pr" | "on_commit" | "on_review" | "scheduled" | "manual" | "on_plan_approved";
+    skill: string;
+    output: "inline" | "artifact" | "auto";
+}, {
+    skill: string;
+    when?: "always" | "on_pr" | "on_commit" | "on_review" | "scheduled" | "manual" | "on_plan_approved" | undefined;
+    output?: "inline" | "artifact" | "auto" | undefined;
+}>]>;
+type CommandStep = z.infer<typeof CommandStepSchema>;
+type SkillStep = z.infer<typeof SkillStepSchema>;
+type Step = z.infer<typeof StepSchema>;
+declare const PersonaTriggerSchema: z.ZodDiscriminatedUnion<"event", [z.ZodObject<{
+    event: z.ZodLiteral<"on_pr">;
+    conditions: z.ZodOptional<z.ZodObject<{
+        paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        min_files: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        timeout: number;
-        autoFix: boolean;
-        severity: "error" | "warning";
+        paths?: string[] | undefined;
+        min_files?: number | undefined;
     }, {
-        timeout?: number | undefined;
-        autoFix?: boolean | undefined;
-        severity?: "error" | "warning" | undefined;
+        paths?: string[] | undefined;
+        min_files?: number | undefined;
     }>>;
-    outputs: z.ZodDefault<z.ZodObject<{
-        'agents-md': z.ZodDefault<z.ZodBoolean>;
-        'ci-workflow': z.ZodDefault<z.ZodBoolean>;
-        'runtime-config': z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    event: "on_pr";
+    conditions?: {
+        paths?: string[] | undefined;
+        min_files?: number | undefined;
+    } | undefined;
+}, {
+    event: "on_pr";
+    conditions?: {
+        paths?: string[] | undefined;
+        min_files?: number | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    event: z.ZodLiteral<"on_commit">;
+    conditions: z.ZodOptional<z.ZodObject<{
+        branches: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
-        'agents-md': boolean;
-        'ci-workflow': boolean;
-        'runtime-config': boolean;
+        branches?: string[] | undefined;
     }, {
-        'agents-md'?: boolean | undefined;
-        'ci-workflow'?: boolean | undefined;
-        'runtime-config'?: boolean | undefined;
+        branches?: string[] | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    name: string;
-    skills: string[];
-    version: 1;
-    description: string;
-    role: string;
-    commands: string[];
-    triggers: ({
-        event: "on_pr";
-        conditions?: {
-            paths?: string[] | undefined;
-        } | undefined;
-    } | {
-        event: "on_commit";
-        conditions?: {
-            branches?: string[] | undefined;
-        } | undefined;
-    } | {
-        event: "scheduled";
-        cron: string;
-    })[];
-    config: {
-        timeout: number;
-        autoFix: boolean;
-        severity: "error" | "warning";
-    };
-    outputs: {
-        'agents-md': boolean;
-        'ci-workflow': boolean;
-        'runtime-config': boolean;
-    };
+    event: "on_commit";
+    conditions?: {
+        branches?: string[] | undefined;
+    } | undefined;
+}, {
+    event: "on_commit";
+    conditions?: {
+        branches?: string[] | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    event: z.ZodLiteral<"scheduled">;
+    cron: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    event: "scheduled";
+    cron: string;
+}, {
+    event: "scheduled";
+    cron: string;
+}>, z.ZodObject<{
+    event: z.ZodLiteral<"manual">;
+}, "strip", z.ZodTypeAny, {
+    event: "manual";
+}, {
+    event: "manual";
+}>]>;
+declare const PersonaConfigSchema: z.ZodObject<{
+    severity: z.ZodDefault<z.ZodEnum<["error", "warning"]>>;
+    autoFix: z.ZodDefault<z.ZodBoolean>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    timeout: number;
+    autoFix: boolean;
+    severity: "error" | "warning";
+}, {
+    timeout?: number | undefined;
+    autoFix?: boolean | undefined;
+    severity?: "error" | "warning" | undefined;
+}>;
+declare const PersonaOutputsSchema: z.ZodObject<{
+    'agents-md': z.ZodDefault<z.ZodBoolean>;
+    'ci-workflow': z.ZodDefault<z.ZodBoolean>;
+    'runtime-config': z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    'agents-md': boolean;
+    'ci-workflow': boolean;
+    'runtime-config': boolean;
 }, {
+    'agents-md'?: boolean | undefined;
+    'ci-workflow'?: boolean | undefined;
+    'runtime-config'?: boolean | undefined;
+}>;
+interface Persona {
+    version: 1 | 2;
     name: string;
-    skills: string[];
-    version: 1;
     description: string;
     role: string;
-    commands: string[];
-    triggers: ({
-        event: "on_pr";
-        conditions?: {
-            paths?: string[] | undefined;
-        } | undefined;
-    } | {
-        event: "on_commit";
-        conditions?: {
-            branches?: string[] | undefined;
-        } | undefined;
-    } | {
-        event: "scheduled";
-        cron: string;
-    })[];
-    config?: {
-        timeout?: number | undefined;
-        autoFix?: boolean | undefined;
-        severity?: "error" | "warning" | undefined;
-    } | undefined;
-    outputs?: {
-        'agents-md'?: boolean | undefined;
-        'ci-workflow'?: boolean | undefined;
-        'runtime-config'?: boolean | undefined;
-    } | undefined;
-}>;
-type Persona = z.infer<typeof PersonaSchema>;
+    skills: string[];
+    steps: Step[];
+    commands?: string[];
+    triggers: z.infer<typeof PersonaTriggerSchema>[];
+    config: z.infer<typeof PersonaConfigSchema>;
+    outputs: z.infer<typeof PersonaOutputsSchema>;
+}
 
 interface PersonaMetadata {
     name: string;
@@ -591,21 +631,103 @@ declare function generateAgentsMd(persona: Persona): Result<string, Error>;
 
 declare function generateCIWorkflow(persona: Persona, platform: 'github' | 'gitlab'): Result<string, Error>;
 
+interface HandoffContext {
+    fromSkill: string;
+    summary: string;
+    pending: string[];
+    planPath?: string;
+}
+interface TriggerDetectionResult {
+    trigger: TriggerContext;
+    handoff?: HandoffContext;
+}
+/**
+ * Detect the appropriate trigger context by inspecting project state.
+ * Returns `on_plan_approved` when a planning handoff with pending tasks exists.
+ * Falls back to `manual` otherwise.
+ */
+declare function detectTrigger(projectPath: string): TriggerDetectionResult;
+
+interface SkillExecutionContext {
+    trigger: TriggerContext;
+    projectPath: string;
+    outputMode: 'inline' | 'artifact' | 'auto';
+    baseSha?: string;
+    headSha?: string;
+    handoff?: HandoffContext;
+}
+interface SkillExecutionResult {
+    status: 'pass' | 'fail';
+    output: string;
+    artifactPath?: string;
+    durationMs: number;
+}
+declare function executeSkill(skillName: string, context: SkillExecutionContext): Promise<SkillExecutionResult>;
+
+interface StepReport {
+    name: string;
+    type: 'command' | 'skill';
+    status: 'pass' | 'fail' | 'skipped';
+    result?: unknown;
+    artifactPath?: string;
+    error?: string;
+    durationMs: number;
+}
 interface PersonaRunReport {
     persona: string;
     status: 'pass' | 'fail' | 'partial';
-    commands: Array<{
-        name: string;
-        status: 'pass' | 'fail' | 'skipped';
-        result?: unknown;
-        error?: string;
-        durationMs: number;
-    }>;
+    steps: StepReport[];
     totalDurationMs: number;
 }
 type CommandExecutor = (command: string) => Promise<Result<unknown, Error>>;
-declare function runPersona(persona: Persona, executor: CommandExecutor): Promise<PersonaRunReport>;
+type SkillExecutor = (skillName: string, context: SkillExecutionContext) => Promise<SkillExecutionResult>;
+interface StepExecutionContext {
+    trigger: TriggerContext | 'auto';
+    commandExecutor: CommandExecutor;
+    skillExecutor: SkillExecutor;
+    projectPath: string;
+    handoff?: HandoffContext;
+}
+declare function runPersona(persona: Persona, context: StepExecutionContext): Promise<PersonaRunReport>;
+
+/**
+ * Commands that the persona runner is allowed to execute via shell.
+ * Shared between CLI agent run command and MCP handler.
+ */
+declare const ALLOWED_PERSONA_COMMANDS: Set<string>;
+
+interface GenerateAgentDefsOptions {
+    platforms: Platform[];
+    global: boolean;
+    output?: string;
+    dryRun: boolean;
+}
+interface GenerateAgentDefsResult {
+    platform: string;
+    added: string[];
+    updated: string[];
+    removed: string[];
+    unchanged: string[];
+    outputDir: string;
+}
+declare function generateAgentDefinitions(opts: GenerateAgentDefsOptions): GenerateAgentDefsResult[];
+
+interface AgentDefinition {
+    name: string;
+    description: string;
+    tools: string[];
+    role: string;
+    skills: string[];
+    steps: Step[];
+    methodology: string;
+}
+declare const AGENT_DESCRIPTIONS: Record<string, string>;
+declare function generateAgentDefinition(persona: Persona, skillContents: Map<string, string>): AgentDefinition;
+
+declare function renderClaudeCodeAgent(def: AgentDefinition): string;
+
+declare function renderGeminiAgent(def: AgentDefinition): string;
 
 declare function createProgram(): Command;
 
-export { CLIError, type CommandExecutor, type CreateSkillOptions, ExitCode, type GenerateResult, type HarnessConfig, OutputFormatter, OutputMode, type Persona, type PersonaMetadata, type PersonaRunReport, type RenderedFiles, type TemplateContext, TemplateEngine, buildPreamble, createProgram, findConfigFile, generateAgentsMd, generateCIWorkflow, generateRuntime, generateSkillFiles, generateSlashCommands, handleError, listPersonas, loadConfig, loadPersona, logger, resolveConfig, runCheckPhaseGate, runCrossCheck, runPersona };
+export { AGENT_DESCRIPTIONS, ALLOWED_PERSONA_COMMANDS, type AgentDefinition, CLIError, type CommandExecutor, type CommandStep, type CreateSkillOptions, ExitCode, type GenerateAgentDefsOptions, type GenerateAgentDefsResult, type GenerateResult, type HandoffContext, type HarnessConfig, OutputFormatter, OutputMode, type Persona, type PersonaMetadata, type PersonaRunReport, type RenderedFiles, type SkillExecutionContext, type SkillExecutionResult, type SkillExecutor, type SkillSource, type SkillStep, type Step, type StepExecutionContext, type StepReport, type TemplateContext, TemplateEngine, type TriggerContext, type TriggerDetectionResult, buildPreamble, createProgram, detectTrigger, executeSkill, findConfigFile, generateAgentDefinition, generateAgentDefinitions, generateAgentsMd, generateCIWorkflow, generateRuntime, generateSkillFiles, generateSlashCommands, handleError, listPersonas, loadConfig, loadPersona, logger, renderClaudeCodeAgent, renderGeminiAgent, resolveConfig, runCheckPhaseGate, runCrossCheck, runGraphExport, runGraphStatus, runIngest, runPersona, runQuery, runScan };

package/dist/index.js

@@ -1,10 +1,16 @@
 import {
+  AGENT_DESCRIPTIONS,
+  ALLOWED_PERSONA_COMMANDS,
   OutputFormatter,
   OutputMode,
   TemplateEngine,
   buildPreamble,
   createProgram,
+  detectTrigger,
+  executeSkill,
   findConfigFile,
+  generateAgentDefinition,
+  generateAgentDefinitions,
   generateAgentsMd,
   generateCIWorkflow,
   generateRuntime,
@@ -12,10 +18,17 @@ import {
   listPersonas,
   loadConfig,
   loadPersona,
+  renderClaudeCodeAgent,
+  renderGeminiAgent,
   resolveConfig,
   runCheckPhaseGate,
-  runPersona
-} from "./chunk-APYEWOCR.js";
+  runGraphExport,
+  runGraphStatus,
+  runIngest,
+  runPersona,
+  runQuery,
+  runScan
+} from "./chunk-VS4OTOKZ.js";
 import {
   runCrossCheck
 } from "./chunk-3U5VZYR7.js";
@@ -25,8 +38,10 @@ import {
   generateSkillFiles,
   handleError,
   logger
-} from "./chunk-EFZOLZFB.js";
+} from "./chunk-ACMDUQJG.js";
 export {
+  AGENT_DESCRIPTIONS,
+  ALLOWED_PERSONA_COMMANDS,
   CLIError,
   ExitCode,
   OutputFormatter,
@@ -34,7 +49,11 @@ export {
   TemplateEngine,
   buildPreamble,
   createProgram,
+  detectTrigger,
+  executeSkill,
   findConfigFile,
+  generateAgentDefinition,
+  generateAgentDefinitions,
   generateAgentsMd,
   generateCIWorkflow,
   generateRuntime,
@@ -45,8 +64,15 @@ export {
   loadConfig,
   loadPersona,
   logger,
+  renderClaudeCodeAgent,
+  renderGeminiAgent,
   resolveConfig,
   runCheckPhaseGate,
   runCrossCheck,
-  runPersona
+  runGraphExport,
+  runGraphStatus,
+  runIngest,
+  runPersona,
+  runQuery,
+  runScan
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-engineering/cli",
-  "version": "1.3.0",
+  "version": "1.6.0",
   "description": "CLI for Harness Engineering toolkit",
   "type": "module",
   "bin": {
@@ -26,7 +26,8 @@
     "handlebars": "^4.7.0",
     "yaml": "^2.3.0",
     "zod": "^3.22.0",
-    "@harness-engineering/core": "0.7.0",
+    "@harness-engineering/core": "0.8.0",
+    "@harness-engineering/graph": "0.2.0",
     "@harness-engineering/linter-gen": "0.1.0"
   },
   "devDependencies": {