@mstar-harness/engine 3.2.5 → 3.3.0

package/dist/index.d.ts

@@ -25,7 +25,7 @@ export { SEVERITY_ORDER, applyEnforcement, readHarnessVersion, readJson, resolve
 export type { HarnessKind, ResolveHarnessDirOptions, ResolveSpecsDirOptions } from "./path.js";
 export type { MstarcConfig } from "./mstarc.js";
 export { MSTARC_FILE, MSTARC_HARNESS_DIR_KEY, MSTARC_PROJECT_DIR_KEY, MSTARC_SECTION, MSTARC_WORKFLOW_DIR_KEY, findMstarc, parseMstarc, } from "./mstarc.js";
-export { assertPlanWritingPath, emitGitignoreSnippet, resolveHarnessDir, resolveIterationDir, resolveKnowledgeDir, resolvePlanDir, resolveProjectDir, resolveSddDir, resolveSpecsDir, resolveWorkflowDir, scaffoldHarness, validateGitignore, } from "./path.js";
+export { assertPlanWritingPath, detectHarnessKind, emitGitignoreSnippet, resolveHarnessDir, resolveIterationDir, resolveKnowledgeDir, resolvePlanDir, resolveProjectDir, resolveScaffoldDirs, resolveSddDir, resolveSpecsDir, resolveWorkflowDir, scaffoldHarness, validateGitignore, } from "./path.js";
 export type { PlanRow, ResidualEntry, StatusDoc, StatusV2Doc, WorkflowEntry, } from "./status.js";
 export { normalizeSeverity, registerWorkflow, resolveCompassEnforcement, resolveMstarcEnforcement, resolveRepoEnforcement, unregisterWorkflow, validatePlanRow, validateResidual, validateStatus, validateStatusV2, validateWorkflowEntry, } from "./status.js";
 export type { ClaimLeaseFields, ExecutionLease, ExecutionLeaseLocations, IntegrationMergeLease, LeaseTransition, LeaseVerifyResult, } from "./lease.js";

package/dist/path.d.ts

@@ -128,11 +128,35 @@ export declare function resolveWorkflowDir(startDir?: string, opts?: ResolveHarn
  */
 export declare function resolveProjectDir(startDir?: string, opts?: ResolveHarnessDirOptions): string;
 /**
- * Initialize the harness directory under `root`: create `.mstar/` with
- * `plans/`, `iterations/`, `knowledge/`, `specs/`, `sdd/` and write
- * `status.json` from the empty template (plan-conventions § 初始化 Plan 目录).
- * Idempotent: an existing non-empty `status.json` is never clobbered.
- * Returns the absolute harness dir.
+ * Resolve the scaffold target dirs for `root` — the harness dir and the
+ * project dir — from the same config source the runtime resolvers use
+ * (plan-conventions § {HARNESS_DIR} 解析顺序): explicit `MSTAR_HARNESS_DIR`
+ * env wins, then `.mstarc` `[config] harness_dir` (found per find-first-stop
+ * within the workspace-root boundary, resolved against the config file's
+ * directory), else the default `.mstar/`. The project dir defaults to
+ * `{HARNESS_DIR}/projects/` with the `.mstarc` `[config] project_dir`
+ * override honored independently (same `mstarcDirOverride` semantics as
+ * `resolveProjectDir`). Unlike `resolveHarnessDir`, the probe rung is
+ * skipped: scaffold initializes the default `.mstar/` even when a legacy
+ * `.agents/` exists (default behavior unchanged without a `.mstarc`).
+ */
+export declare function resolveScaffoldDirs(root: string): {
+    harnessDir: string;
+    projectDir: string;
+};
+/**
+ * Initialize the harness directory under `root`: create the resolved
+ * harness dir (default `.mstar/`, or the `.mstarc`-declared `harness_dir`
+ * / `MSTAR_HARNESS_DIR` override — see `resolveScaffoldDirs`) with `plans/`,
+ * `iterations/`, `knowledge/`, `specs/`, `sdd/`, write `status.json` from
+ * the empty template, and prebuild the v3 project layer `_default/` under
+ * the resolved project dir (default `{HARNESS_DIR}/projects/`, or the
+ * `.mstarc`-declared `project_dir`) with a valid `roadmap.md` + empty
+ * `residuals.json` (plan-conventions § 初始化 Plan 目录;
+ * mstar-project-governance § `_default` 回退). Idempotent: an existing
+ * non-empty `status.json`, `roadmap.md`, or `residuals.json` is never
+ * clobbered; re-running on an initialized tree only creates missing
+ * pieces. Returns the absolute resolved harness dir.
  */
 export declare function scaffoldHarness(root: string): string;
 /**
@@ -166,6 +190,8 @@ export declare function emitGitignoreSnippet(kind?: HarnessKind): string;
  * `ValidationResult` (v1 enforcement depth, roadmap §8.5).
  */
 export declare function validateGitignore(root: string): ValidationResult;
+/** Detect the gitignore fence kind from a resolved harness dir (basename). */
+export declare function detectHarnessKind(harnessDir: string | null): HarnessKind | null;
 /**
  * Plan-writing path gate (plan-conventions § Plan-Writing Path Gate +
  * harness-core 护栏): plans must live under `{PLAN_DIR}`; external default

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mstar-harness/engine",
-  "version": "3.2.5",
+  "version": "3.3.0",
   "description": "Morning Star Harness Workflow Engine — deterministic workflow enforcement library (path, status, lease, dispatch, sdd, iteration, lint gates).",
   "license": "MIT",
   "repository": {