@ytinnovation/harness-core 0.0.0

package/dist/mcp/tools/sync-spec.js

@@ -0,0 +1,80 @@
+import { stat } from 'node:fs/promises';
+import { resolve } from 'node:path';
+export const SYNC_SPEC_TOOL = {
+    name: 'sync_spec',
+    description: 'Resolve and validate the configured spec mount path for workspace synchronization.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            mountPath: {
+                type: 'string',
+                description: 'Optional relative mount path override. Defaults to the configured Harness spec mount path.',
+            },
+        },
+        additionalProperties: false,
+    },
+};
+function isNodeError(error) {
+    return typeof error === 'object' && error !== null && 'code' in error;
+}
+function classifySyncSpecError(error) {
+    if (isNodeError(error)) {
+        if (error.code === 'EACCES' || error.code === 'EPERM') {
+            return 'permission-denied';
+        }
+        if (error.code === 'ECANCELED' || error.code === 'ABORT_ERR') {
+            return 'user-cancelled';
+        }
+        if (error.code === 'ECONNRESET'
+            || error.code === 'ENETUNREACH'
+            || error.code === 'ETIMEDOUT'
+            || error.code === 'EAI_AGAIN') {
+            return 'network-error';
+        }
+    }
+    return 'unavailable';
+}
+export async function syncSpecTool(input, context) {
+    const configuredPath = typeof input?.mountPath === 'string' && input.mountPath.trim().length > 0
+        ? input.mountPath.trim()
+        : context.harnessConfig?.specMountPath?.trim();
+    if (!configuredPath) {
+        return {
+            status: 'unavailable',
+            message: 'No spec mount path configured. Set harnessConfig.specMountPath before calling sync_spec.',
+            data: null,
+            errorCode: 'unavailable',
+        };
+    }
+    const resolvedPath = resolve(context.workspaceRoot, configuredPath);
+    try {
+        const details = await stat(resolvedPath);
+        const sourceType = details.isDirectory() ? 'directory' : 'file';
+        return {
+            status: 'success',
+            message: `Resolved spec source at ${configuredPath}.`,
+            data: {
+                configuredMountPath: configuredPath,
+                resolvedPath,
+                sourceType,
+            },
+        };
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === 'ENOENT') {
+            return {
+                status: 'unavailable',
+                message: `Configured spec mount path does not exist: ${configuredPath}.`,
+                data: null,
+                errorCode: 'not-found',
+            };
+        }
+        return {
+            status: 'error',
+            message: `Failed to inspect configured spec mount path: ${configuredPath}.`,
+            data: null,
+            errorCode: classifySyncSpecError(error),
+        };
+    }
+}
+//# sourceMappingURL=sync-spec.js.map

package/dist/mcp/tools/sync-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-spec.js","sourceRoot":"","sources":["../../../src/mcp/tools/sync-spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,oFAAoF;IACjG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,4FAA4F;aAC/F;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC;AAEF,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,CAAC;AACxE,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACtD,OAAO,mBAAmB,CAAC;QAC7B,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC7D,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QAED,IACE,KAAK,CAAC,IAAI,KAAK,YAAY;eACxB,KAAK,CAAC,IAAI,KAAK,aAAa;eAC5B,KAAK,CAAC,IAAI,KAAK,WAAW;eAC1B,KAAK,CAAC,IAAI,KAAK,WAAW,EAC7B,CAAC;YACD,OAAO,eAAe,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAgC,EAChC,OAA4B;IAE5B,MAAM,cAAc,GAClB,OAAO,KAAK,EAAE,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACvE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE;QACxB,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IAEnD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO;YACL,MAAM,EAAE,aAAa;YACrB,OAAO,EACL,0FAA0F;YAC5F,IAAI,EAAE,IAAI;YACV,SAAS,EAAE,aAAa;SACzB,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAEpE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;QAChE,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,2BAA2B,cAAc,GAAG;YACrD,IAAI,EAAE;gBACJ,mBAAmB,EAAE,cAAc;gBACnC,YAAY;gBACZ,UAAU;aACX;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClD,OAAO;gBACL,MAAM,EAAE,aAAa;gBACrB,OAAO,EAAE,8CAA8C,cAAc,GAAG;gBACxE,IAAI,EAAE,IAAI;gBACV,SAAS,EAAE,WAAW;aACvB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,iDAAiD,cAAc,GAAG;YAC3E,IAAI,EAAE,IAAI;YACV,SAAS,EAAE,qBAAqB,CAAC,KAAK,CAAC;SACxC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/mcp/tools/update-rule.d.ts

@@ -0,0 +1,49 @@
+import type { McpToolDefinition, McpToolResult } from '../types.js';
+export interface UpdateRuleToolContext {
+    workspaceRoot: string;
+}
+export type RuleUpdateMode = 'auto-merge' | 'view-diff' | 'keep-local';
+export interface UpdateRuleInput {
+    ruleName?: string;
+    targetPath?: string;
+    mode?: RuleUpdateMode;
+    dryRun?: boolean;
+}
+export interface ResolvedRuleUpdate {
+    baseContent: string;
+    targetContent: string;
+    targetVersion: string;
+    targetRevision: string | null;
+    source: string;
+}
+export interface ResolveRuleUpdateInput {
+    ruleName: string;
+    currentVersion: string;
+    currentRevision: string | null;
+    source: string;
+}
+export interface UpdateRuleData {
+    ruleName: string;
+    targetPath: string;
+    source: string;
+    currentVersion: string;
+    targetVersion: string;
+    currentRevision: string | null;
+    targetRevision: string | null;
+    action: RuleUpdateMode;
+    options: RuleUpdateMode[];
+    requestedMode: RuleUpdateMode | null;
+    hasLocalChanges: boolean;
+    hasRemoteChanges: boolean;
+    dryRun: boolean;
+    reason: string;
+    conflictSummary?: string;
+}
+export interface UpdateRuleToolDependencies {
+    resolveRuleUpdate: (input: ResolveRuleUpdateInput) => Promise<ResolvedRuleUpdate | null>;
+}
+export declare const UPDATE_RULE_TOOL: McpToolDefinition;
+export declare function createUpdateRuleTool(dependencies?: Partial<UpdateRuleToolDependencies>): (input: UpdateRuleInput | undefined, context: UpdateRuleToolContext) => Promise<McpToolResult<UpdateRuleData>>;
+export declare const updateRuleTool: (input: UpdateRuleInput | undefined, context: UpdateRuleToolContext) => Promise<McpToolResult<UpdateRuleData>>;
+export type UpdateRuleTool = ReturnType<typeof createUpdateRuleTool>;
+//# sourceMappingURL=update-rule.d.ts.map

package/dist/mcp/tools/update-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-rule.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/update-rule.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAoB,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtF,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,aAAa,EAAE,cAAc,GAAG,IAAI,CAAC;IACrC,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,iBAAiB,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;CAC1F;AAID,eAAO,MAAM,gBAAgB,EAAE,iBA4B9B,CAAC;AAsDF,wBAAgB,oBAAoB,CAAC,YAAY,GAAE,OAAO,CAAC,0BAA0B,CAAM,WAOhF,eAAe,GAAG,SAAS,WACzB,qBAAqB,KAC7B,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAqH1C;AAED,eAAO,MAAM,cAAc,UAzHhB,eAAe,GAAG,SAAS,WACzB,qBAAqB,KAC7B,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAuHU,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/mcp/tools/update-rule.js

@@ -0,0 +1,188 @@
+import { readFile } from 'node:fs/promises';
+import { isAbsolute, join } from 'node:path';
+import { parseLocalRuleMetadataStore } from '../../assets/metadata.js';
+import { HarnessError } from '../../contracts/errors.js';
+import { planSkillUpdate } from '../../skills/update.js';
+const DEFAULT_RULE_METADATA_RELATIVE_PATH = ['.harness', 'rules', 'metadata.json'];
+export const UPDATE_RULE_TOOL = {
+    name: 'update_rule',
+    description: 'Build a safe update plan for a local rule using metadata, without overwriting local changes.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            ruleName: {
+                type: 'string',
+                description: 'Rule name from local metadata store.',
+            },
+            targetPath: {
+                type: 'string',
+                description: 'Optional override target path for local rule file.',
+            },
+            mode: {
+                type: 'string',
+                enum: ['auto-merge', 'view-diff', 'keep-local'],
+                description: 'Optional preferred mode for this update plan.',
+            },
+            dryRun: {
+                type: 'boolean',
+                description: 'When true, return plan only. This tool never overwrites local files.',
+            },
+        },
+        required: ['ruleName'],
+        additionalProperties: false,
+    },
+};
+function isNodeError(error) {
+    return typeof error === 'object' && error !== null && 'code' in error;
+}
+function classifyRuleUpdateError(error) {
+    if (error instanceof HarnessError) {
+        if (error.code === 'RULE_METADATA_INVALID_STORE'
+            || error.code === 'RULE_METADATA_INVALID_RECORD'
+            || error.code === 'ASSET_METADATA_INVALID') {
+            return 'unavailable';
+        }
+    }
+    if (isNodeError(error)) {
+        if (error.code === 'EACCES' || error.code === 'EPERM') {
+            return 'permission-denied';
+        }
+        if (error.code === 'ECONNRESET' || error.code === 'ENETUNREACH' || error.code === 'ETIMEDOUT') {
+            return 'network-error';
+        }
+    }
+    return 'unavailable';
+}
+function resolveRuleMetadataPath(workspaceRoot) {
+    return join(workspaceRoot, ...DEFAULT_RULE_METADATA_RELATIVE_PATH);
+}
+function resolveRuleTargetPath(workspaceRoot, metadataTargetPath, input) {
+    const configuredPath = input.targetPath?.trim();
+    if (configuredPath && configuredPath.length > 0) {
+        if (isAbsolute(configuredPath)) {
+            return configuredPath;
+        }
+        return join(workspaceRoot, configuredPath);
+    }
+    if (isAbsolute(metadataTargetPath)) {
+        return metadataTargetPath;
+    }
+    return join(workspaceRoot, metadataTargetPath);
+}
+function createDefaultDependencies() {
+    return {
+        resolveRuleUpdate: async () => null,
+    };
+}
+export function createUpdateRuleTool(dependencies = {}) {
+    const merged = {
+        ...createDefaultDependencies(),
+        ...dependencies,
+    };
+    return async function updateRuleTool(input, context) {
+        const ruleName = input?.ruleName?.trim() ?? '';
+        if (ruleName.length === 0) {
+            return {
+                status: 'error',
+                message: 'A non-empty `ruleName` is required when calling update_rule.',
+                data: null,
+                errorCode: 'user-cancelled',
+            };
+        }
+        try {
+            const metadataPath = resolveRuleMetadataPath(context.workspaceRoot);
+            const serializedStore = await readFile(metadataPath, 'utf8');
+            const store = parseLocalRuleMetadataStore(serializedStore);
+            const localRuleRecord = store.records.find((record) => record.ruleName === ruleName);
+            if (!localRuleRecord) {
+                return {
+                    status: 'error',
+                    message: `Local metadata for rule "${ruleName}" was not found.`,
+                    data: null,
+                    errorCode: 'not-found',
+                };
+            }
+            const resolvedUpdate = await merged.resolveRuleUpdate({
+                ruleName,
+                currentVersion: localRuleRecord.metadata.version,
+                currentRevision: localRuleRecord.metadata.revision,
+                source: localRuleRecord.metadata.source,
+            });
+            if (!resolvedUpdate) {
+                return {
+                    status: 'error',
+                    message: `Remote rule "${ruleName}" was not found for update planning.`,
+                    data: null,
+                    errorCode: 'not-found',
+                };
+            }
+            const targetPath = resolveRuleTargetPath(context.workspaceRoot, localRuleRecord.targetPath, input ?? {});
+            const localContent = await readFile(targetPath, 'utf8');
+            const plan = planSkillUpdate({
+                skillName: ruleName,
+                currentRevision: localRuleRecord.metadata.revision,
+                targetRevision: resolvedUpdate.targetRevision ?? '',
+                baseContent: resolvedUpdate.baseContent,
+                localContent,
+                targetContent: resolvedUpdate.targetContent,
+            });
+            const hasLocalChanges = localContent !== resolvedUpdate.baseContent;
+            const hasRemoteChanges = resolvedUpdate.targetContent !== resolvedUpdate.baseContent;
+            const options = hasLocalChanges
+                ? ['view-diff', 'keep-local', 'auto-merge']
+                : ['auto-merge', 'keep-local'];
+            const requestedMode = input?.mode ?? null;
+            if (requestedMode && !options.includes(requestedMode)) {
+                return {
+                    status: 'error',
+                    message: `Requested mode "${requestedMode}" is not available for rule "${ruleName}".`,
+                    data: null,
+                    errorCode: 'user-cancelled',
+                };
+            }
+            const action = requestedMode ?? plan.action;
+            const dryRun = input?.dryRun === true;
+            return {
+                status: 'success',
+                message: `Rule ${ruleName} update plan generated with action ${action}.`,
+                data: {
+                    ruleName,
+                    targetPath,
+                    source: resolvedUpdate.source,
+                    currentVersion: localRuleRecord.metadata.version,
+                    targetVersion: resolvedUpdate.targetVersion,
+                    currentRevision: localRuleRecord.metadata.revision,
+                    targetRevision: resolvedUpdate.targetRevision,
+                    action,
+                    options,
+                    requestedMode,
+                    hasLocalChanges,
+                    hasRemoteChanges,
+                    dryRun,
+                    reason: hasLocalChanges
+                        ? 'Local modifications detected; choose a safe merge strategy before applying updates.'
+                        : 'No local modifications detected; auto-merge is safe.',
+                    conflictSummary: plan.conflictSummary,
+                },
+            };
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code === 'ENOENT') {
+                return {
+                    status: 'error',
+                    message: `Rule metadata or target file is missing for "${ruleName}".`,
+                    data: null,
+                    errorCode: 'not-found',
+                };
+            }
+            return {
+                status: 'error',
+                message: error instanceof Error ? error.message : String(error),
+                data: null,
+                errorCode: classifyRuleUpdateError(error),
+            };
+        }
+    };
+}
+export const updateRuleTool = createUpdateRuleTool();
+//# sourceMappingURL=update-rule.js.map

package/dist/mcp/tools/update-rule.js.map

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

package/dist/mcp/types.d.ts

@@ -0,0 +1,21 @@
+export type McpJsonSchema = Record<string, unknown>;
+export declare const MCP_TOOL_ERROR_CODES: readonly ["permission-denied", "not-found", "network-error", "user-cancelled", "unavailable"];
+export type McpToolErrorCode = (typeof MCP_TOOL_ERROR_CODES)[number];
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: McpJsonSchema;
+}
+export interface McpToolResult<TData = Record<string, unknown>> {
+    status: 'success' | 'error' | 'unavailable';
+    message: string;
+    data: TData | null;
+    errorCode?: McpToolErrorCode;
+}
+export interface McpServerOptions {
+    serverName: string;
+    serverVersion: string;
+    workspaceRoot: string;
+    tools: McpToolDefinition[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD,eAAO,MAAM,oBAAoB,+FAMvB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,aAAa,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B"}

package/dist/mcp/types.js

@@ -0,0 +1,8 @@
+export const MCP_TOOL_ERROR_CODES = [
+    'permission-denied',
+    'not-found',
+    'network-error',
+    'user-cancelled',
+    'unavailable',
+];
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,mBAAmB;IACnB,WAAW;IACX,eAAe;IACf,gBAAgB;IAChB,aAAa;CACL,CAAC"}

package/dist/prompt/command.d.ts

@@ -0,0 +1,10 @@
+import type { CommandRouter } from '../kernel/router.js';
+export interface PromptCommandOptions {
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+}
+declare function renderPromptHelp(programName?: string): string;
+export declare function runPromptCommand(args: string[], options?: PromptCommandOptions): Promise<number>;
+export declare function registerPromptCommand(router: CommandRouter): void;
+export { renderPromptHelp };
+//# sourceMappingURL=command.d.ts.map

package/dist/prompt/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/prompt/command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAczD,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAKD,iBAAS,gBAAgB,CAAC,WAAW,SAAY,GAAG,MAAM,CAoBzD;AA4HD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+I1G;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAEjE;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/prompt/command.js

@@ -0,0 +1,260 @@
+import { HarnessError } from '../contracts/errors.js';
+import { fetchPublishedAssetByName } from '../assets/fetch-published-by-name.js';
+import { createEnterpriseAssetClient } from '../cloud/enterprise-asset-client.js';
+import { copyTextToClipboard } from '../cli-output/clipboard.js';
+import { renderErrorBlock, renderJson, renderRemoteAssetList, renderSuccessBlock, renderWarningBlock, } from '../cli-output/renderers.js';
+import { formatRemoteTopAsset } from '../assets/remote-list.js';
+const DEFAULT_LIST_LIMIT = 50;
+const MAX_LIST_LIMIT = 200;
+function renderPromptHelp(programName = 'harness') {
+    return [
+        '查看与取用 Harness Prompt 提示词资产。',
+        '',
+        '用法：',
+        `  ${programName} prompt list [--remote] [--query <text>] [--limit <n>] [--json]`,
+        `  ${programName} prompt get <name> [--no-copy] [--json]`,
+        '',
+        '子命令：',
+        '  list          列出企业服务中的已发布 Prompt（默认远程列表）。',
+        '  get <name>    读取并输出 Prompt 正文；默认复制到系统剪贴板。',
+        '',
+        '选项：',
+        '  --remote      显式指定远程列表（与默认行为相同）。',
+        '  --query       按名称或描述模糊搜索。',
+        '  --limit       列表条数上限，默认 50，最大 200。',
+        '  --no-copy     get 时不写入剪贴板。',
+        '  --json        输出机器可读 JSON。',
+        '  -h, --help    查看帮助。',
+    ].join('\n');
+}
+function parseListOptions(args) {
+    let json = false;
+    let query;
+    let limit = DEFAULT_LIST_LIMIT;
+    const unknown = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (!arg) {
+            continue;
+        }
+        if (arg === '--json') {
+            json = true;
+            continue;
+        }
+        if (arg === '--remote') {
+            continue;
+        }
+        if (arg === '--query') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('--')) {
+                throw new HarnessError('PROMPT_INVALID_ARGS', 'Missing value for --query.');
+            }
+            query = value.trim();
+            index += 1;
+            continue;
+        }
+        if (arg === '--limit') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('--')) {
+                throw new HarnessError('PROMPT_INVALID_ARGS', 'Missing value for --limit.');
+            }
+            const parsed = Number.parseInt(value, 10);
+            if (!Number.isFinite(parsed) || parsed <= 0) {
+                throw new HarnessError('PROMPT_INVALID_ARGS', '`--limit` must be a positive integer.');
+            }
+            limit = Math.min(parsed, MAX_LIST_LIMIT);
+            index += 1;
+            continue;
+        }
+        unknown.push(arg);
+    }
+    return { json, query, limit, unknown };
+}
+function parseGetOptions(args) {
+    let json = false;
+    let noCopy = false;
+    const rest = [];
+    for (const arg of args) {
+        if (arg === '--json') {
+            json = true;
+            continue;
+        }
+        if (arg === '--no-copy') {
+            noCopy = true;
+            continue;
+        }
+        rest.push(arg);
+    }
+    const name = rest[0]?.trim();
+    if (!name || rest.length !== 1) {
+        throw new HarnessError('PROMPT_INVALID_ARGS', '用法：harness prompt get <name> [--no-copy] [--json]');
+    }
+    return { json, noCopy, name };
+}
+async function listRemotePrompts(args) {
+    const client = createEnterpriseAssetClient({
+        baseUrl: args.options.baseUrl,
+        fetchImpl: args.options.fetchImpl,
+    });
+    if (!client) {
+        throw new HarnessError('HARNESS_SERVICE_UNAVAILABLE', 'HARNESS_SERVICE_URL is not configured');
+    }
+    const items = await client.searchPublished({
+        type: 'prompt',
+        query: args.query,
+        sort: 'download_count',
+        limit: args.limit,
+    });
+    const assets = [];
+    for (const item of items) {
+        const remote = formatRemoteTopAsset({
+            type: item.type,
+            name: item.name,
+            assetId: item.id,
+            version: item.latestPublished?.version ?? null,
+            downloadCount: item.downloadCount,
+            rating: item.rating,
+        });
+        if (remote?.type === 'prompt') {
+            assets.push(remote);
+        }
+    }
+    return assets.sort((left, right) => {
+        if (right.downloadCount !== left.downloadCount) {
+            return right.downloadCount - left.downloadCount;
+        }
+        return left.name.localeCompare(right.name);
+    });
+}
+export async function runPromptCommand(args, options = {}) {
+    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+        console.log(renderPromptHelp());
+        return 0;
+    }
+    const subcommand = args[0];
+    if (subcommand === 'list') {
+        try {
+            const parsed = parseListOptions(args.slice(1));
+            if (parsed.unknown.length > 0) {
+                console.error(renderErrorBlock({
+                    title: 'Prompt 列表参数无效',
+                    message: `未知参数：${parsed.unknown.join(' ')}`,
+                    code: 'PROMPT_INVALID_ARGS',
+                    suggestions: ['运行 harness prompt list --help 查看支持的选项。'],
+                }));
+                return 1;
+            }
+            const assets = await listRemotePrompts({
+                query: parsed.query,
+                limit: parsed.limit,
+                options,
+            });
+            if (parsed.json) {
+                console.log(renderJson({ assets, pagination: { limit: parsed.limit, total: assets.length } }));
+                return 0;
+            }
+            const subtitle = parsed.query ? `搜索词：${parsed.query}` : undefined;
+            console.log(renderRemoteAssetList(subtitle ? `远程 Prompt（${subtitle}）` : '远程 Prompt 提示词', assets));
+            return 0;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(renderErrorBlock({ title: '远程 Prompt 列表读取失败', message }));
+            return 1;
+        }
+    }
+    if (subcommand === 'get') {
+        try {
+            const parsed = parseGetOptions(args.slice(1));
+            const client = createEnterpriseAssetClient({
+                baseUrl: options.baseUrl,
+                fetchImpl: options.fetchImpl,
+            });
+            if (!client) {
+                console.error(renderErrorBlock({
+                    title: 'Prompt 读取失败',
+                    message: 'HARNESS_SERVICE_URL is not configured.',
+                    code: 'HARNESS_SERVICE_UNAVAILABLE',
+                }));
+                return 1;
+            }
+            const asset = await fetchPublishedAssetByName({
+                client,
+                type: 'prompt',
+                name: parsed.name,
+            });
+            let downloadCount;
+            try {
+                downloadCount = await client.recordDownload(asset.assetId);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                console.error(renderWarningBlock('下载量未更新', [['原因', message]], ['Prompt 正文仍可使用。']));
+            }
+            let copied = false;
+            let copyReason;
+            if (!parsed.noCopy) {
+                const copyResult = await copyTextToClipboard(asset.content);
+                copied = copyResult.ok;
+                if (!copyResult.ok) {
+                    copyReason = copyResult.reason;
+                }
+            }
+            if (parsed.json) {
+                console.log(renderJson({
+                    name: asset.name,
+                    assetId: asset.assetId,
+                    version: asset.version,
+                    description: asset.description,
+                    content: asset.content,
+                    downloadCount,
+                    copied,
+                    copyReason,
+                }));
+                return 0;
+            }
+            console.log(asset.content);
+            if (parsed.noCopy) {
+                console.log('');
+                console.log(renderSuccessBlock('Prompt 已输出', [
+                    ['名称', asset.name],
+                    ['版本', asset.version],
+                    ...(downloadCount !== undefined ? [['下载量', downloadCount]] : []),
+                ]));
+                return 0;
+            }
+            if (copied) {
+                console.log('');
+                console.log(renderSuccessBlock('Prompt 已复制到剪贴板', [
+                    ['名称', asset.name],
+                    ['版本', asset.version],
+                    ...(downloadCount !== undefined ? [['下载量', downloadCount]] : []),
+                ], ['可直接粘贴到 Cursor Chat 或其他 AI 工具中使用。']));
+                return 0;
+            }
+            console.log('');
+            console.log(renderWarningBlock('未能写入剪贴板', [
+                ['名称', asset.name],
+                ['原因', copyReason ?? '未知错误'],
+            ], ['正文已在上方输出，请手动复制。']));
+            return 0;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(renderErrorBlock({ title: 'Prompt 读取失败', message }));
+            return 1;
+        }
+    }
+    console.error(renderErrorBlock({
+        title: 'Prompt 子命令无效',
+        message: `未知子命令：${subcommand}`,
+        code: 'PROMPT_INVALID_ARGS',
+        suggestions: ['运行 harness prompt --help 查看用法。'],
+    }));
+    return 1;
+}
+export function registerPromptCommand(router) {
+    router.register('prompt', (argv) => runPromptCommand(argv));
+}
+export { renderPromptHelp };
+//# sourceMappingURL=command.js.map