@dotcontext/cli 0.8.1 → 0.9.0

package/dist/generators/skills/skillGenerator.js

@@ -3,7 +3,7 @@
  * Skill Generator
  *
  * Scaffolds skill directories and SKILL.md files.
- * Generates frontmatter-only files (scaffold v2) for AI to fill.
+ * Generates scaffold v2 files with fillable frontmatter plus useful starter content.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -47,6 +47,7 @@ const skills_1 = require("../../workflow/skills");
 const skillTemplate_1 = require("./templates/skillTemplate");
 const indexTemplate_1 = require("./templates/indexTemplate");
 const scaffoldFrontmatter_1 = require("../../types/scaffoldFrontmatter");
+const scaffoldStructures_1 = require("../shared/scaffoldStructures");
 class SkillGenerator {
     constructor(options) {
         this.repoPath = options.repoPath;
@@ -73,7 +74,7 @@ class SkillGenerator {
             }
             // Create skill directory
             fs.mkdirSync(skillDir, { recursive: true });
-            // Generate frontmatter-only content (scaffold v2)
+            // Generate scaffold content with internal frontmatter plus starter body
             let description;
             let phases;
             if ((0, skills_1.isBuiltInSkill)(skillName)) {
@@ -87,9 +88,9 @@ class SkillGenerator {
                 description = `On-demand expertise for ${skillName}`;
                 phases = (0, skillTemplate_1.getDefaultPhases)(skillName);
             }
-            // Create frontmatter-only content
+            // Create scaffold content
             const frontmatter = (0, scaffoldFrontmatter_1.createSkillFrontmatter)(this.formatSkillTitle(skillName), description, skillName, { phases });
-            const content = (0, scaffoldFrontmatter_1.serializeFrontmatter)(frontmatter) + '\n';
+            const content = (0, scaffoldFrontmatter_1.serializeFrontmatter)(frontmatter) + '\n' + this.buildSkillBody(skillName);
             // Write SKILL.md
             fs.writeFileSync(skillPath, content, 'utf-8');
             generatedSkills.push(skillName);
@@ -112,6 +113,46 @@ class SkillGenerator {
             .map(word => word.charAt(0).toUpperCase() + word.slice(1))
             .join(' ');
     }
+    buildSkillBody(skillName) {
+        const structure = (0, scaffoldStructures_1.getScaffoldStructure)(skillName);
+        if (structure) {
+            return (0, scaffoldStructures_1.serializeStructureAsMarkdown)(structure);
+        }
+        return [
+            '## Workflow',
+            '',
+            `<!-- Write the minimum reliable procedure for ${skillName}. Use imperative steps, stay concise, and focus on what another Codex instance would not infer on its own. -->`,
+            '',
+            '1. Inspect the task inputs, constraints, and desired outcome.',
+            '2. Execute the smallest reliable sequence for the task.',
+            '3. Validate the result against real files, commands, or behavior.',
+            '4. Add reusable helpers only if they reduce future repetition.',
+            '',
+            '## Examples',
+            '',
+            `<!-- Add one or two short examples that show when ${skillName} should be used and what good output looks like. -->`,
+            '',
+            '```text',
+            `User: Use the ${skillName} skill to handle this task.`,
+            'Assistant: Follow the workflow, apply repository-specific rules, and produce the requested output.',
+            '```',
+            '',
+            '## Quality Bar',
+            '',
+            '- Keep the skill concise; include only non-obvious guidance.',
+            '- Put activation triggers in the description frontmatter, not in the body.',
+            '- Use imperative instructions and short examples.',
+            '- Prefer progressive disclosure over large inline explanations.',
+            '',
+            '## Resource Strategy',
+            '',
+            '- Add `scripts/` only for deterministic or repetitive work.',
+            '- Add `references/` only for large details that should be loaded on demand.',
+            '- Add `assets/` only for files consumed by the final output.',
+            '- Avoid extra docs such as `README.md` or `CHANGELOG.md` inside the skill folder.',
+            '',
+        ].join('\n');
+    }
     /**
      * Generate a single custom skill
      */
@@ -124,9 +165,9 @@ class SkillGenerator {
         }
         // Create skill directory
         fs.mkdirSync(skillDir, { recursive: true });
-        // Generate frontmatter-only content (scaffold v2)
+        // Generate scaffold content with internal frontmatter plus starter body
         const frontmatter = (0, scaffoldFrontmatter_1.createSkillFrontmatter)(this.formatSkillTitle(name), description, name, { phases });
-        const content = (0, scaffoldFrontmatter_1.serializeFrontmatter)(frontmatter) + '\n';
+        const content = (0, scaffoldFrontmatter_1.serializeFrontmatter)(frontmatter) + '\n' + this.buildSkillBody(name);
         // Write SKILL.md
         fs.writeFileSync(skillPath, content, 'utf-8');
         // Update index

package/dist/generators/skills/skillGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"skillGenerator.js","sourceRoot":"","sources":["../../../src/generators/skills/skillGenerator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skillGenerator.js","sourceRoot":"","sources":["../../../src/generators/skills/skillGenerator.ts"],"names":[],"mappings":"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"}

package/dist/generators/skills/templates/indexTemplate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"indexTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/skills/templates/indexTemplate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAuGvE"}
+{"version":3,"file":"indexTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/skills/templates/indexTemplate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CA8GvE"}

package/dist/generators/skills/templates/indexTemplate.js

@@ -59,33 +59,40 @@ Create a new skill by adding a directory with a \`SKILL.md\` file:
 \`\`\`
 .context/skills/
 └── my-skill/
-    ├── SKILL.md          # Required: skill definition
-    └── templates/        # Optional: helper resources
-        └── checklist.md
+    ├── SKILL.md          # Required: source skill definition
+    ├── scripts/          # Optional: deterministic helpers
+    ├── references/       # Optional: load-on-demand details
+    └── assets/           # Optional: output resources
 \`\`\`
 
-### SKILL.md Format
+### Skill Anatomy
+
+\`\`\`md
+The source file under \`.context/skills/\` keeps internal scaffold metadata so dotcontext can track fill status.
+When exported to AI-tool skill directories, the portable frontmatter should keep only:
 
-\`\`\`yaml
 ---
 name: my-skill
-description: When to use this skill
-phases: [P, E, V]  # Optional: PREVC phases
-mode: false        # Optional: mode command?
+description: Describe what the skill does and the concrete triggers for when to use it
 ---
 
-# My Skill
-
-## When to Use
-[Description of when this skill applies]
-
-## Instructions
+## Workflow
 1. Step one
 2. Step two
 
 ## Examples
-[Usage examples]
 \`\`\`
+[Short example]
+\`\`\`
+
+## Quality Bar
+- List the checks and constraints that keep the skill reliable
+
+## Resource Strategy
+- Explain when to add \`scripts/\`, \`references/\`, or \`assets/\`
+\`\`\`
+
+Keep activation language in the description frontmatter, keep the body concise, and avoid extra docs such as \`README.md\` or \`CHANGELOG.md\` inside the skill folder.
 
 ## PREVC Phase Mapping
 

package/dist/generators/skills/templates/indexTemplate.js.map

@@ -1 +1 @@
-{"version":3,"file":"indexTemplate.js","sourceRoot":"","sources":["../../../../src/generators/skills/templates/indexTemplate.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAYH,kDAuGC;AA1GD;;GAEG;AACH,SAAgB,mBAAmB,CAAC,OAA2B;IAC7D,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAExC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAElD,IAAI,OAAO,GAAG;;;;CAIf,CAAC;IAEA,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,IAAI,cAAc,WAAW,MAAM,CAAC;IAC7C,CAAC;IAED,OAAO,IAAI;;;;;;;;CAQZ,CAAC;IAEA,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI;;;;CAId,CAAC;QAEE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;YACxD,OAAO,IAAI,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,gBAAgB,KAAK,CAAC,QAAQ,CAAC,WAAW,MAAM,MAAM,MAAM,CAAC;QACpH,CAAC;QAED,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI;;;;CAId,CAAC;QAEE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;YACxD,OAAO,IAAI,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,gBAAgB,KAAK,CAAC,QAAQ,CAAC,WAAW,MAAM,MAAM,MAAM,CAAC;QACpH,CAAC;QAED,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IAED,OAAO,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CZ,CAAC;IAEA,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"indexTemplate.js","sourceRoot":"","sources":["../../../../src/generators/skills/templates/indexTemplate.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAYH,kDA8GC;AAjHD;;GAEG;AACH,SAAgB,mBAAmB,CAAC,OAA2B;IAC7D,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAExC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAElD,IAAI,OAAO,GAAG;;;;CAIf,CAAC;IAEA,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,IAAI,cAAc,WAAW,MAAM,CAAC;IAC7C,CAAC;IAED,OAAO,IAAI;;;;;;;;CAQZ,CAAC;IAEA,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI;;;;CAId,CAAC;QAEE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;YACxD,OAAO,IAAI,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,gBAAgB,KAAK,CAAC,QAAQ,CAAC,WAAW,MAAM,MAAM,MAAM,CAAC;QACpH,CAAC;QAED,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI;;;;CAId,CAAC;QAEE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;YACxD,OAAO,IAAI,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,gBAAgB,KAAK,CAAC,QAAQ,CAAC,WAAW,MAAM,MAAM,MAAM,CAAC;QACpH,CAAC;QAED,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IAED,OAAO,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDZ,CAAC;IAEA,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/harness/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Harness boundary exports.
+ *
+ * This module defines the reusable runtime surface that is expected to
+ * become the future `dotcontext/harness` package. It intentionally excludes
+ * CLI-only concerns and MCP transport adapters.
+ */
+export { WorkflowService, type WorkflowServiceDependencies, type WorkflowInitOptions, type WorkflowHarnessStatus, HarnessWorkflowBlockedError, } from '../services/workflow';
+export { HarnessAgentsService, type HarnessAgentsServiceOptions, HarnessPlansService, type HarnessPlansServiceOptions, HarnessContextService, type HarnessContextServiceOptions, HarnessSkillsService, type HarnessSkillsServiceOptions, type HarnessBootstrapStatusResult, HarnessRuntimeStateService, type HarnessRuntimeStateServiceOptions, type HarnessSessionStatus, type HarnessTraceLevel, type HarnessArtifactKind, type HarnessSessionRecord, type HarnessSessionCheckpoint, type HarnessTraceRecord, type HarnessArtifactRecord, type HarnessRuntimeStatePort, type CreateSessionInput, type AppendTraceInput, type AddArtifactInput, type CheckpointInput, HarnessSensorsService, HarnessSensorCatalogService, type HarnessSensorsServiceOptions, type HarnessSensorCatalogServiceOptions, type HarnessSensorSeverity, type HarnessSensorStatus, type HarnessSensorExecutionInput, type HarnessSensorExecutionResult, type HarnessSensorDefinition, type HarnessSensorRun, type HarnessBackpressurePolicy, type HarnessBackpressureResult, type HarnessShellSensorConfig, type HarnessSensorCatalogDocument, type HarnessSensorCatalogSeverity, HarnessTaskContractsService, type HarnessTaskContractsServiceOptions, type HarnessTaskContractStatus, type HarnessTaskContract, type HarnessHandoffContract, type HarnessTaskCompletionResult, HarnessExecutionService, type HarnessExecutionServiceOptions, type HarnessSessionQualitySnapshot, HarnessReplayService, type HarnessReplayServiceOptions, type HarnessReplayDependencies, type HarnessReplayEvent, type HarnessReplayEventSource, type HarnessReplayRecord, type ReplaySessionOptions, HarnessDatasetService, type HarnessDatasetServiceOptions, type HarnessDatasetDependencies, type BuildHarnessDatasetOptions, type HarnessFailureKind, type HarnessFailureRecord, type HarnessFailureCluster, type HarnessFailureDataset, HarnessPolicyService, HarnessPolicyBlockedError, type HarnessPolicyServiceOptions, type HarnessPolicyTarget, type HarnessPolicyScope, type HarnessPolicyEffect, type HarnessPolicyRisk, type HarnessPolicyRule, type CreateHarnessPolicyRuleInput, type HarnessPolicyEvaluationInput, type HarnessPolicyEvaluationResult, HarnessWorkflowStateService, type HarnessWorkflowStateServiceOptions, type HarnessWorkflowRecord, type WorkflowHarnessBinding, } from '../services/harness';
+export { getScaleName, PHASE_NAMES_PT, ROLE_DISPLAY_NAMES, type PrevcRole, } from '../workflow';
+//# sourceMappingURL=index.d.ts.map

package/dist/harness/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,eAAe,EACf,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,qBAAqB,EACrB,KAAK,4BAA4B,EACjC,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,0BAA0B,EAC1B,KAAK,iCAAiC,EACtC,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,4BAA4B,EACjC,KAAK,kCAAkC,EACvC,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,2BAA2B,EAC3B,KAAK,kCAAkC,EACvC,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,uBAAuB,EACvB,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,qBAAqB,EACrB,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,oBAAoB,EACpB,yBAAyB,EACzB,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,2BAA2B,EAC3B,KAAK,kCAAkC,EACvC,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,KAAK,SAAS,GACf,MAAM,aAAa,CAAC"}

package/dist/harness/index.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Harness boundary exports.
+ *
+ * This module defines the reusable runtime surface that is expected to
+ * become the future `dotcontext/harness` package. It intentionally excludes
+ * CLI-only concerns and MCP transport adapters.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_DISPLAY_NAMES = exports.PHASE_NAMES_PT = exports.getScaleName = exports.HarnessWorkflowStateService = exports.HarnessPolicyBlockedError = exports.HarnessPolicyService = exports.HarnessDatasetService = exports.HarnessReplayService = exports.HarnessExecutionService = exports.HarnessTaskContractsService = exports.HarnessSensorCatalogService = exports.HarnessSensorsService = exports.HarnessRuntimeStateService = exports.HarnessSkillsService = exports.HarnessContextService = exports.HarnessPlansService = exports.HarnessAgentsService = exports.HarnessWorkflowBlockedError = exports.WorkflowService = void 0;
+var workflow_1 = require("../services/workflow");
+Object.defineProperty(exports, "WorkflowService", { enumerable: true, get: function () { return workflow_1.WorkflowService; } });
+Object.defineProperty(exports, "HarnessWorkflowBlockedError", { enumerable: true, get: function () { return workflow_1.HarnessWorkflowBlockedError; } });
+var harness_1 = require("../services/harness");
+Object.defineProperty(exports, "HarnessAgentsService", { enumerable: true, get: function () { return harness_1.HarnessAgentsService; } });
+Object.defineProperty(exports, "HarnessPlansService", { enumerable: true, get: function () { return harness_1.HarnessPlansService; } });
+Object.defineProperty(exports, "HarnessContextService", { enumerable: true, get: function () { return harness_1.HarnessContextService; } });
+Object.defineProperty(exports, "HarnessSkillsService", { enumerable: true, get: function () { return harness_1.HarnessSkillsService; } });
+Object.defineProperty(exports, "HarnessRuntimeStateService", { enumerable: true, get: function () { return harness_1.HarnessRuntimeStateService; } });
+Object.defineProperty(exports, "HarnessSensorsService", { enumerable: true, get: function () { return harness_1.HarnessSensorsService; } });
+Object.defineProperty(exports, "HarnessSensorCatalogService", { enumerable: true, get: function () { return harness_1.HarnessSensorCatalogService; } });
+Object.defineProperty(exports, "HarnessTaskContractsService", { enumerable: true, get: function () { return harness_1.HarnessTaskContractsService; } });
+Object.defineProperty(exports, "HarnessExecutionService", { enumerable: true, get: function () { return harness_1.HarnessExecutionService; } });
+Object.defineProperty(exports, "HarnessReplayService", { enumerable: true, get: function () { return harness_1.HarnessReplayService; } });
+Object.defineProperty(exports, "HarnessDatasetService", { enumerable: true, get: function () { return harness_1.HarnessDatasetService; } });
+Object.defineProperty(exports, "HarnessPolicyService", { enumerable: true, get: function () { return harness_1.HarnessPolicyService; } });
+Object.defineProperty(exports, "HarnessPolicyBlockedError", { enumerable: true, get: function () { return harness_1.HarnessPolicyBlockedError; } });
+Object.defineProperty(exports, "HarnessWorkflowStateService", { enumerable: true, get: function () { return harness_1.HarnessWorkflowStateService; } });
+var workflow_2 = require("../workflow");
+Object.defineProperty(exports, "getScaleName", { enumerable: true, get: function () { return workflow_2.getScaleName; } });
+Object.defineProperty(exports, "PHASE_NAMES_PT", { enumerable: true, get: function () { return workflow_2.PHASE_NAMES_PT; } });
+Object.defineProperty(exports, "ROLE_DISPLAY_NAMES", { enumerable: true, get: function () { return workflow_2.ROLE_DISPLAY_NAMES; } });
+//# sourceMappingURL=index.js.map

package/dist/harness/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,iDAM8B;AAL5B,2GAAA,eAAe,OAAA;AAIf,uHAAA,2BAA2B,OAAA;AAE7B,+CA8E6B;AA7E3B,+GAAA,oBAAoB,OAAA;AAEpB,8GAAA,mBAAmB,OAAA;AAEnB,gHAAA,qBAAqB,OAAA;AAErB,+GAAA,oBAAoB,OAAA;AAGpB,qHAAA,0BAA0B,OAAA;AAc1B,gHAAA,qBAAqB,OAAA;AACrB,sHAAA,2BAA2B,OAAA;AAc3B,sHAAA,2BAA2B,OAAA;AAM3B,kHAAA,uBAAuB,OAAA;AAGvB,+GAAA,oBAAoB,OAAA;AAOpB,gHAAA,qBAAqB,OAAA;AAQrB,+GAAA,oBAAoB,OAAA;AACpB,oHAAA,yBAAyB,OAAA;AAUzB,sHAAA,2BAA2B,OAAA;AAM7B,wCAKqB;AAJnB,wGAAA,YAAY,OAAA;AACZ,0GAAA,cAAc,OAAA;AACd,8GAAA,kBAAkB,OAAA"}