buddy-agent-harness 0.22.0 → 1.0.1

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { MatchKind, ReferenceLayer, ReferenceLayerOptions as ReferenceLayerOptions$1, ReferenceLayers, ReferenceListLayerRow, ReferenceListLayerRow as ReferenceListLayerRow$1, ReferenceListRow, ReferenceListing, ReferenceName, ReferenceStatus, ReferenceTier, ResolveOptions, ResolvedReference, SearchMatch, listReferences, parseReferenceName, resolveReference, searchReferences } from "cyber-agentkit";
 import { cli as cli$1 } from "clibuilder";
-import { ReferenceListReport, ReferenceSearchReport, ReferenceShowEntry } from "cyber-agentkit/commands";
+import { ReferenceListReport, ReferenceLoadEntry, ReferenceSearchReport } from "cyber-agentkit/commands";
 //#region src/cli.d.ts
 /**
  * The application boundary: argv in, exit code out — returned rather than written, so a caller that
@@ -655,5 +655,5 @@ type ReferenceLayerOptions = Omit<ReferenceLayerOptions$1, "plugin"> & {
 export declare function referenceLayers({ packageRoot, ...options }: ReferenceLayerOptions): Promise<ReferenceLayers>;
 export declare const referenceCommand: cli$1.Command;
 //#endregion
-export { type BridgeFinding, type BridgeKind, type BridgeProblem, type BridgeReport, type BridgeStatus, type ConfigurationFault, type ConfigurationProblem, type DiagnoseMcpOptions, type DiagnoseOptions, type DiagnoseResult, type DivergenceDirection, type DivergenceReport, type DoctorProblem, type DoctorReference, type DoctorReport, type GlobalInstructionKind, type GlobalInstructionProblem, type GlobalInstructionReport, type GlobalInstructionStatus, type GovernanceDocument, type GovernanceEntry, type GovernanceLayer, type GovernanceListReport, type GovernanceScope, type GovernanceShowReport, type Harness, type HarnessName, type HarnessScope, type HarnessScopeName, type InitializeOptions, type InitializeResult, type InstructionBridge, type InstructionKind, type InstructionProblem, type InstructionReport, type InstructionStatus, type LayerOptions, type ListMcpServersOptions, type MatchKind, type McpConfig, type McpDirection, type McpField, type McpProblem, type McpServer, type McpServerEntry, type McpTransport, type ReferenceLayer, type ReferenceLayerOptions, type ReferenceListLayerRow, type ReferenceListReport, type ReferenceListRow, type ReferenceListing, type ReferenceName, type ReferenceSearchReport, type ReferenceShowEntry, type ReferenceStatus, type ReferenceTier, type Repair, type ResolveOptions, type ResolvedReference, type SearchMatch, listReferences, parseReferenceName, resolveReference, searchReferences };
+export { type BridgeFinding, type BridgeKind, type BridgeProblem, type BridgeReport, type BridgeStatus, type ConfigurationFault, type ConfigurationProblem, type DiagnoseMcpOptions, type DiagnoseOptions, type DiagnoseResult, type DivergenceDirection, type DivergenceReport, type DoctorProblem, type DoctorReference, type DoctorReport, type GlobalInstructionKind, type GlobalInstructionProblem, type GlobalInstructionReport, type GlobalInstructionStatus, type GovernanceDocument, type GovernanceEntry, type GovernanceLayer, type GovernanceListReport, type GovernanceScope, type GovernanceShowReport, type Harness, type HarnessName, type HarnessScope, type HarnessScopeName, type InitializeOptions, type InitializeResult, type InstructionBridge, type InstructionKind, type InstructionProblem, type InstructionReport, type InstructionStatus, type LayerOptions, type ListMcpServersOptions, type MatchKind, type McpConfig, type McpDirection, type McpField, type McpProblem, type McpServer, type McpServerEntry, type McpTransport, type ReferenceLayer, type ReferenceLayerOptions, type ReferenceListLayerRow, type ReferenceListReport, type ReferenceListRow, type ReferenceListing, type ReferenceLoadEntry, type ReferenceName, type ReferenceSearchReport, type ReferenceStatus, type ReferenceTier, type Repair, type ResolveOptions, type ResolvedReference, type SearchMatch, listReferences, parseReferenceName, resolveReference, searchReferences };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/cli.ts","../src/harness-registry/instruction-bridge.ts","../src/diagnose-mcp/mcp-model.ts","../src/mcp-dialects/mcp-dialects.ts","../src/harness-registry/mcp-config.ts","../src/harness-registry/nonstandard-artifact.ts","../src/harness-registry/harness-registry.ts","../src/diagnose-bridges/diagnose-global-instructions.ts","../src/diagnose-bridges/diagnose-instructions.ts","../src/diagnose-bridges/locator.ts","../src/diagnose-bridges/doctor-guidance.ts","../src/diagnose-bridges/git-bridge-state.ts","../src/diagnose-bridges/diagnose-bridges.ts","../src/diagnose-configuration/diagnose-configuration.ts","../src/diagnose-bridges/doctor.command.ts","../src/diagnose-mcp/diagnose-mcp.ts","../src/diagnose-mcp/mcp-baseline.ts","../src/diagnose-mcp/mcp-sources.ts","../src/governance-overrides/governance-overrides.ts","../src/governance-overrides/governance.command.ts","../src/initialize-harnesses/init.command.ts","../src/skill-projection/skill-projection.ts","../src/initialize-harnesses/initialize-harnesses.ts","../src/mcp-inventory/mcp-inventory.ts","../src/references/references.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/cli.ts","../src/harness-registry/instruction-bridge.ts","../src/diagnose-mcp/mcp-model.ts","../src/mcp-dialects/mcp-dialects.ts","../src/harness-registry/mcp-config.ts","../src/harness-registry/nonstandard-artifact.ts","../src/harness-registry/harness-registry.ts","../src/diagnose-bridges/diagnose-global-instructions.ts","../src/diagnose-bridges/diagnose-instructions.ts","../src/diagnose-bridges/locator.ts","../src/diagnose-bridges/doctor-guidance.ts","../src/diagnose-bridges/git-bridge-state.ts","../src/diagnose-bridges/diagnose-bridges.ts","../src/diagnose-configuration/diagnose-configuration.ts","../src/diagnose-bridges/doctor.command.ts","../src/diagnose-mcp/diagnose-mcp.ts","../src/diagnose-mcp/mcp-baseline.ts","../src/diagnose-mcp/mcp-sources.ts","../src/governance-overrides/governance-overrides.ts","../src/governance-overrides/governance.command.ts","../src/initialize-harnesses/init.command.ts","../src/skill-projection/skill-projection.ts","../src/initialize-harnesses/initialize-harnesses.ts","../src/mcp-inventory/mcp-inventory.ts","../src/references/references.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { declaredDependencies, listReferences, listReferences as listReferences$1, packageDir, parseReferenceName, projectReferencesDir, referenceLayers as referenceLayers$1, referenceNames, resolveReference, searchReferences, skillsDirectories } from "cyber-agentkit";
+import { declaredDependencies, listReferences, listReferences as listReferences$1, packageDir, parseReferenceName, referenceLayers as referenceLayers$1, referenceNames, repoReferencesDir, resolveReference, searchReferences, skillsDirectories } from "cyber-agentkit";
 import { cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, realpathSync, rmSync, statSync, symlinkSync, writeFileSync } from "node:fs";
 import { cli, command, t } from "clibuilder";
 import { CliError, document, exitCodes, isCliError, printAnswer, result } from "clibuilder/axi";
@@ -2993,7 +2993,7 @@ function layersFor(args) {
 	});
 	return args["overrides-only"] ? overrideLayers(layers) : layers;
 }
-const GOVERNANCE_DEPRECATED = "warning: \"governance\" is deprecated and will be removed in the next major version; use \"reference show|list\" instead.\n";
+const GOVERNANCE_DEPRECATED = "warning: \"governance\" is deprecated and will be removed in the next major version; use \"reference load|list\" instead.\n";
 const DEPRECATED_MANAGED = "deprecated — move these documents to the managed layer above";
 const rootOption = {
 	description: "Repository or package directory. Defaults to the current directory.",
@@ -3076,14 +3076,20 @@ const governanceCommand = command({
 });
 //#endregion
 //#region src/initialize-harnesses/initialize-harnesses.ts
+/** Git does not track an empty directory, so an empty one gets a `.gitkeep` to survive a commit and clone. */
+function keepWhenEmpty(directory) {
+	if (readdirSync(directory).length === 0) writeFileSync(join(directory, ".gitkeep"), "");
+}
 function initializeHarnesses({ root, harnesses: preferred = [], copy = false, force = false }) {
 	const canonicalSkills = join(root, ".agents", "skills");
 	const skills = countSkills(canonicalSkills);
-	mkdirSync(projectReferencesDir(root), { recursive: true });
+	mkdirSync(repoReferencesDir(root), { recursive: true });
 	const references = referenceNames([{
-		tier: "project",
-		dir: projectReferencesDir(root)
+		tier: "repo",
+		dir: repoReferencesDir(root)
 	}]).length;
+	keepWhenEmpty(canonicalSkills);
+	keepWhenEmpty(repoReferencesDir(root));
 	const harnesses = selectHarnesses(root, preferred);
 	const { linked, skipped } = projectSkills({
 		root,
@@ -3941,14 +3947,14 @@ function app(format) {
 }
 const textByDefault = {
 	reference: [
-		"show",
+		"load",
 		"create",
 		"delete"
 	],
 	governance: ["show"]
 };
 /**
-* `reference show|create|delete` and `governance show` answer in `text` unless `--format` says
+* `reference load|create|delete` and `governance show` answer in `text` unless `--format` says
 * otherwise; every other command answers in `toon`. clibuilder has one global `--format` default,
 * so it is chosen from the command the argv names.
 */