@dzhechkov/harness-core 0.4.4 → 0.5.0

package/dist/skills.d.ts

@@ -22,8 +22,93 @@ export interface SkillInfo {
 }
 /** Return the ids of every `<skillsDir>/<id>/SKILL.md`, sorted. */
 export declare function discoverSkillIds(skillsDir: string): string[];
-/** Discover every skill in `skillsDir`, returning id + description. */
+/**
+ * Discover every skill in `skillsDir`, returning id + description.
+ *
+ * **Throws on the first unloadable skill — deliberately, and permanently.** This is a
+ * published export; silently turning it into a skip-and-collect function would downgrade
+ * every unknown third-party consumer from fail-closed to fail-silent without their
+ * consent (an incomplete catalogue reported as complete). Callers that want a partial
+ * listing ask for one by name: {@link listSkillsDetailed}. A pinned regression test
+ * asserts this function still throws, so a future "helpful" refactor cannot quietly
+ * erase the strict variant. (feature dz-cli-defects, ADR-001 as amended by AM-6.)
+ */
 export declare function listSkills(skillsDir: string): SkillSummary[];
+/** How much of the offending file's first line is echoed back to the user. */
+export declare const SKILL_FAILURE_FIRST_LINE_MAX = 100;
+/** One skill directory that could not be loaded. Named, so a log is actionable. */
+export interface SkillLoadFailure {
+    /** The skill id (its directory name), e.g. `bto`. */
+    readonly id: string;
+    /** ABSOLUTE path to the offending `SKILL.md`. */
+    readonly path: string;
+    /** The caught error's message, verbatim — the classifier stays out of the loader. */
+    readonly reason: string;
+    /**
+     * First line of the source text, trimmed and capped at
+     * {@link SKILL_FAILURE_FIRST_LINE_MAX}; `''` when the file is unreadable. Echoing it
+     * is what turns the message into a FIX — the user sees the H1 and knows to add the
+     * frontmatter fence.
+     */
+    readonly firstLine: string;
+}
+/** A listing that separates what parsed from what did not. */
+export interface SkillListing {
+    /** Sorted by id — same order, same shape as {@link listSkills} produces today. */
+    readonly skills: readonly SkillSummary[];
+    /** Sorted by id. Empty when every skill loaded. */
+    readonly failures: readonly SkillLoadFailure[];
+}
+/**
+ * Attribute any skill-load throw to a file. Shared by every consumer
+ * (`listSkillsDetailed`, `runInit`, `runInitSingleFileMd`, `runSync`).
+ *
+ * Best-effort on the first line: an unreadable file yields `''` rather than a second
+ * throw — this helper runs on an error path and must never become one.
+ */
+export declare function describeSkillLoadFailure(skillsDir: string, id: string, error: unknown): SkillLoadFailure;
+/**
+ * Discover every skill in `skillsDir`, separating the ones that parsed from the ones
+ * that did not. One broken `SKILL.md` never hides the rest.
+ *
+ * Catch policy: **every** error per id, not only `SkillDocumentError` — an `EACCES`, a
+ * YAML syntax error and a Zod schema rejection are all equally "this one skill is
+ * unusable". The `reason` is the caught message verbatim.
+ */
+export declare function listSkillsDetailed(skillsDir: string): SkillListing;
+/**
+ * Render a `SkillLoadFailure[]` as the diagnostic block a CLI writes to **stderr**.
+ *
+ * One helper, two rendering modes, chosen by the CALLER — never by the helper sniffing
+ * the path. `dz list` / `dz sync` print absolute paths (the user can act on those);
+ * `dz install` passes `relativeTo` = the downloaded package root, because a
+ * `node_modules/**` absolute path is not something the user can act on.
+ *
+ * Returns `[]` for an empty input, so callers can splice it unconditionally.
+ */
+export declare function formatSkillLoadFailures(failures: readonly SkillLoadFailure[], opts?: {
+    readonly relativeTo?: string;
+}): string[];
+/**
+ * One skill that LOADED cleanly but could not be compiled for, or written to, the
+ * target. The subject is the TARGET, never the source `SKILL.md`.
+ */
+export interface SkillApplyFailure {
+    /** The skill id (its directory name). */
+    readonly id: string;
+    /** The caught error's message, verbatim. */
+    readonly reason: string;
+}
+/**
+ * Render a `SkillApplyFailure[]` as the diagnostic block a CLI writes to **stderr**.
+ *
+ * Deliberately a DIFFERENT header from {@link formatSkillLoadFailures}: the two kinds
+ * point the user at two different files, and a shared header is what let a write
+ * failure masquerade as a parse failure.
+ *
+ * Returns `[]` for an empty input, so callers can splice it unconditionally.
+ */
+export declare function formatSkillApplyFailures(failures: readonly SkillApplyFailure[]): string[];
 /** Get detailed info about a single skill without loading all assets. */
 export declare function getSkillInfo(skillsDir: string, id: string): SkillInfo | undefined;
 /**

package/dist/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,iBAAiB,CAAC;AAElE,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,2BAA2B;AAC3B,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/C;AAsCD,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAM5D;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CAM5D;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAqBjF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,cAAc,CAoB9E"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,iBAAiB,CAAC;AAElE,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,2BAA2B;AAC3B,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/C;AAsCD,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAM5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CAM5D;AAWD,8EAA8E;AAC9E,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAChD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,GACb,gBAAgB,CAmBlB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAalE;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,IAAI,GAAE;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1C,MAAM,EAAE,CAaV;AAeD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAQzF;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAqBjF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,cAAc,CAoB9E"}

package/dist/skills.js

@@ -52,7 +52,17 @@ export function discoverSkillIds(skillsDir) {
         .map((entry) => entry.name)
         .sort();
 }
-/** Discover every skill in `skillsDir`, returning id + description. */
+/**
+ * Discover every skill in `skillsDir`, returning id + description.
+ *
+ * **Throws on the first unloadable skill — deliberately, and permanently.** This is a
+ * published export; silently turning it into a skip-and-collect function would downgrade
+ * every unknown third-party consumer from fail-closed to fail-silent without their
+ * consent (an incomplete catalogue reported as complete). Callers that want a partial
+ * listing ask for one by name: {@link listSkillsDetailed}. A pinned regression test
+ * asserts this function still throws, so a future "helpful" refactor cannot quietly
+ * erase the strict variant. (feature dz-cli-defects, ADR-001 as amended by AM-6.)
+ */
 export function listSkills(skillsDir) {
     return discoverSkillIds(skillsDir).map((id) => {
         const document = parseSkillDocument(readFileSync(join(skillsDir, id, 'SKILL.md'), 'utf-8'));
@@ -60,6 +70,111 @@ export function listSkills(skillsDir) {
         return { id, description: frontmatter.description };
     });
 }
+// ---------------------------------------------------------------------------
+// Skip-and-collect (feature dz-cli-defects, D1)
+//
+// The parser (`@dzhechkov/core/src/skill-document.ts`) is handed only TEXT, so its
+// message can never carry a path. `describeSkillLoadFailure` is the ONE place that
+// turns a pathless throw into a named failure — every consumer calls it, so "named,
+// never anonymous" has one implementation and one test.
+// ---------------------------------------------------------------------------
+/** How much of the offending file's first line is echoed back to the user. */
+export const SKILL_FAILURE_FIRST_LINE_MAX = 100;
+/**
+ * Attribute any skill-load throw to a file. Shared by every consumer
+ * (`listSkillsDetailed`, `runInit`, `runInitSingleFileMd`, `runSync`).
+ *
+ * Best-effort on the first line: an unreadable file yields `''` rather than a second
+ * throw — this helper runs on an error path and must never become one.
+ */
+export function describeSkillLoadFailure(skillsDir, id, error) {
+    const path = join(skillsDir, id, 'SKILL.md');
+    let firstLine = '';
+    try {
+        const raw = readFileSync(path, 'utf-8');
+        const line = (raw.split('\n', 1)[0] ?? '').replace(/\r$/, '').trim();
+        firstLine =
+            line.length > SKILL_FAILURE_FIRST_LINE_MAX
+                ? `${line.slice(0, SKILL_FAILURE_FIRST_LINE_MAX)}…`
+                : line;
+    }
+    catch {
+        firstLine = '';
+    }
+    return {
+        id,
+        path,
+        reason: error instanceof Error ? error.message : String(error),
+        firstLine,
+    };
+}
+/**
+ * Discover every skill in `skillsDir`, separating the ones that parsed from the ones
+ * that did not. One broken `SKILL.md` never hides the rest.
+ *
+ * Catch policy: **every** error per id, not only `SkillDocumentError` — an `EACCES`, a
+ * YAML syntax error and a Zod schema rejection are all equally "this one skill is
+ * unusable". The `reason` is the caught message verbatim.
+ */
+export function listSkillsDetailed(skillsDir) {
+    const skills = [];
+    const failures = [];
+    for (const id of discoverSkillIds(skillsDir)) {
+        try {
+            const document = parseSkillDocument(readFileSync(join(skillsDir, id, 'SKILL.md'), 'utf-8'));
+            const frontmatter = ClaudeSkillFrontmatterSchema.parse(parseYaml(document.frontmatterYaml));
+            skills.push({ id, description: frontmatter.description });
+        }
+        catch (error) {
+            failures.push(describeSkillLoadFailure(skillsDir, id, error));
+        }
+    }
+    return { skills, failures };
+}
+/**
+ * Render a `SkillLoadFailure[]` as the diagnostic block a CLI writes to **stderr**.
+ *
+ * One helper, two rendering modes, chosen by the CALLER — never by the helper sniffing
+ * the path. `dz list` / `dz sync` print absolute paths (the user can act on those);
+ * `dz install` passes `relativeTo` = the downloaded package root, because a
+ * `node_modules/**` absolute path is not something the user can act on.
+ *
+ * Returns `[]` for an empty input, so callers can splice it unconditionally.
+ */
+export function formatSkillLoadFailures(failures, opts = {}) {
+    if (failures.length === 0)
+        return [];
+    const lines = [`⚠ ${failures.length} skill(s) skipped (unparseable SKILL.md):`];
+    for (const failure of failures) {
+        const shown = opts.relativeTo !== undefined
+            ? relative(opts.relativeTo, failure.path).split('\\').join('/')
+            : failure.path;
+        lines.push(`  ${shown}`);
+        lines.push(`    ${failure.reason}`);
+        if (failure.firstLine !== '')
+            lines.push(`    (line 1: ${JSON.stringify(failure.firstLine)})`);
+    }
+    return lines;
+}
+/**
+ * Render a `SkillApplyFailure[]` as the diagnostic block a CLI writes to **stderr**.
+ *
+ * Deliberately a DIFFERENT header from {@link formatSkillLoadFailures}: the two kinds
+ * point the user at two different files, and a shared header is what let a write
+ * failure masquerade as a parse failure.
+ *
+ * Returns `[]` for an empty input, so callers can splice it unconditionally.
+ */
+export function formatSkillApplyFailures(failures) {
+    if (failures.length === 0)
+        return [];
+    const lines = [`✗ ${failures.length} skill(s) failed to install (compile/write error):`];
+    for (const failure of failures) {
+        lines.push(`  ${failure.id}`);
+        lines.push(`    ${failure.reason}`);
+    }
+    return lines;
+}
 /** Get detailed info about a single skill without loading all assets. */
 export function getSkillInfo(skillsDir, id) {
     const skillDir = join(skillsDir, id);

package/dist/skills.js.map

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

package/dist/targets.d.ts

@@ -15,4 +15,79 @@ export declare const TARGETS: Record<TargetName, Adapter>;
 export declare const TARGET_NAMES: TargetName[];
 /** Type guard: is `value` a supported `--target` name? */
 export declare function isTargetName(value: string): value is TargetName;
+/** `TARGET_NAMES` sorted alphabetically, for display in error messages. */
+export declare const TARGET_NAMES_SORTED: readonly TargetName[];
+/**
+ * Semantic `--target` aliases — DATA, not branching logic. Adding a row is one line
+ * and zero control flow (ADR-002 §Rationale D5).
+ *
+ * Purely typographic variants (`Claude_Code`, `claudecode`, `agents.md`) are handled by
+ * normalisation, not by rows; the rows below carry only meanings normalisation cannot
+ * derive (`claude` ≠ `claude-code` by any string rule — it is an owner decision).
+ */
+export declare const TARGET_ALIASES: Readonly<Record<string, TargetName>>;
+/**
+ * Rows deleted in fix round 1 (QE F7) because they were UNREACHABLE, not because their
+ * inputs stopped working: `claude_code`, `claudecode`, `agentsmd` and `agents.md` all
+ * normalise onto a canonical name, and precedence step 2 (normalised canonical) runs
+ * BEFORE step 3 (this table). Every one of them still resolves — through normalisation,
+ * which is where the README already says typographic variants are handled.
+ *
+ * They were invisible dead data because the table test iterated every row asserting
+ * `via === 'alias'`, which is true on both paths — a PRESENCE assertion where a
+ * REACHABILITY one was intended. `target-resolution.test.ts` now removes each row from a
+ * COPY of the table and asserts the resolution changes, so a future dead row is red.
+ */
+/** The outcome of {@link resolveTargetName}. Total: every string maps to one of these. */
+export type TargetResolution = {
+    readonly kind: 'ok';
+    readonly target: TargetName;
+    readonly via: 'canonical' | 'alias';
+} | {
+    readonly kind: 'unknown';
+    readonly input: string;
+    readonly suggestion: TargetName | null;
+};
+/** Levenshtein suggestions are only offered at or below this edit distance. */
+export declare const TARGET_SUGGESTION_MAX_DISTANCE = 3;
+/**
+ * Normalise a `--target` token for matching: byte-level lowercase (never
+ * `toLocaleLowerCase` — behaviour must not vary with the host locale), trimmed, with
+ * every separator dropped so `Claude_Code`, `claude-code` and `claudecode` collapse.
+ *
+ * Exported so the alias-REACHABILITY test can ask the production normaliser whether a
+ * proposed alias row is already carried by precedence step 2, instead of keeping a
+ * second copy of this rule in the test file (fix round 1, QE F7).
+ */
+export declare function normalizeTargetToken(value: string): string;
+/**
+ * Resolve a user-supplied `--target` value to a canonical {@link TargetName}.
+ *
+ * Total, pure, no I/O. Precedence (fixed and tested):
+ *
+ * 1. exact canonical hit → `{kind:'ok', via:'canonical'}` (`isTargetName` semantics);
+ * 2. normalised canonical hit → `{kind:'ok', via:'alias'}` (`Claude_Code`, `agentsmd`);
+ * 3. explicit {@link TARGET_ALIASES} row → `{kind:'ok', via:'alias'}`;
+ * 4. unique normalised prefix → `{kind:'unknown', suggestion}`;
+ * 5. Levenshtein ≤ 3 strictly better than the runner-up → `{kind:'unknown', suggestion}`;
+ * 6. otherwise → `{kind:'unknown', suggestion:null}`.
+ *
+ * **Aliases ACCEPT; prefix and Levenshtein only SUGGEST.** An alias row is an owner
+ * decision recorded in data; a fuzzy match is a guess, and silently installing to the
+ * wrong target on a guess is worse than one round-trip.
+ */
+export declare function resolveTargetName(value: string): TargetResolution;
+/**
+ * Render the two-line failure for an unresolvable `--target`.
+ *
+ * Line 2 keeps the literal substring `--target must be one of:` — three shipped
+ * assertions (`test/cli.test.ts`) pin it, and keeping the shape additive is what makes
+ * the D3 change prove itself with NEW tests instead of rewriting old ones. The values
+ * are {@link TARGET_NAMES_SORTED} (alphabetical), which the pre-change message was not.
+ */
+export declare function formatTargetProblem(command: string, resolution: Extract<TargetResolution, {
+    kind: 'unknown';
+}>): readonly string[];
+/** The one-line diagnostic emitted (on stderr) when an alias was accepted. */
+export declare function formatTargetAliasNote(command: string, input: string, target: TargetName): string;
 //# sourceMappingURL=targets.d.ts.map

package/dist/targets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;GAGG;AACH,+BAA+B;AAC/B,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAKrJ,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,CAa/C,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,YAAY,EAA2B,UAAU,EAAE,CAAC;AAEjE,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D"}
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;GAGG;AACH,+BAA+B;AAC/B,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAKrJ,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,CAa/C,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,YAAY,EAA2B,UAAU,EAAE,CAAC;AAEjE,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAWD,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,EAAE,SAAS,UAAU,EAA6B,CAAC;AAEnF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAM/D,CAAC;AAEF;;;;;;;;;;;GAWG;AAGH,0FAA0F;AAC1F,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAA;CAAE,GACzF;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAA;CAAE,CAAC;AAEjG,+EAA+E;AAC/E,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAkED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAmBjE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,OAAO,CAAC,gBAAgB,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,GACzD,SAAS,MAAM,EAAE,CAOnB;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAEhG"}

package/dist/targets.js

@@ -36,4 +36,164 @@ export const TARGET_NAMES = Object.keys(TARGETS);
 export function isTargetName(value) {
     return Object.prototype.hasOwnProperty.call(TARGETS, value);
 }
+// ---------------------------------------------------------------------------
+// `--target` resolution — alias table + did-you-mean (feature dz-cli-defects, D3)
+//
+// `isTargetName`, `TARGETS` and `TARGET_NAMES` above are UNCHANGED: `boundaries.json`
+// names `isTargetName` as the scanned validation boundary for `--target`, and every
+// resolution below ends in exactly that guard, so the security boundary is preserved
+// rather than relocated (ADR-002 / architecture §3.1).
+// ---------------------------------------------------------------------------
+/** `TARGET_NAMES` sorted alphabetically, for display in error messages. */
+export const TARGET_NAMES_SORTED = [...TARGET_NAMES].sort();
+/**
+ * Semantic `--target` aliases — DATA, not branching logic. Adding a row is one line
+ * and zero control flow (ADR-002 §Rationale D5).
+ *
+ * Purely typographic variants (`Claude_Code`, `claudecode`, `agents.md`) are handled by
+ * normalisation, not by rows; the rows below carry only meanings normalisation cannot
+ * derive (`claude` ≠ `claude-code` by any string rule — it is an owner decision).
+ */
+export const TARGET_ALIASES = {
+    claude: 'claude-code',
+    cc: 'claude-code',
+    agents: 'agents-md',
+    gpt: 'codex',
+    openai: 'codex',
+};
+/** Levenshtein suggestions are only offered at or below this edit distance. */
+export const TARGET_SUGGESTION_MAX_DISTANCE = 3;
+/**
+ * Normalise a `--target` token for matching: byte-level lowercase (never
+ * `toLocaleLowerCase` — behaviour must not vary with the host locale), trimmed, with
+ * every separator dropped so `Claude_Code`, `claude-code` and `claudecode` collapse.
+ *
+ * Exported so the alias-REACHABILITY test can ask the production normaliser whether a
+ * proposed alias row is already carried by precedence step 2, instead of keeping a
+ * second copy of this rule in the test file (fix round 1, QE F7).
+ */
+export function normalizeTargetToken(value) {
+    return value.trim().toLowerCase().replace(/[-_.\s]/g, '');
+}
+/** Iterative two-row Levenshtein. No dependency: harness-core ships no fuzzy matcher. */
+function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    let prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+    let curr = new Array(b.length + 1).fill(0);
+    for (let i = 1; i <= a.length; i += 1) {
+        curr[0] = i;
+        for (let j = 1; j <= b.length; j += 1) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            curr[j] = Math.min((curr[j - 1] ?? 0) + 1, (prev[j] ?? 0) + 1, (prev[j - 1] ?? 0) + cost);
+        }
+        const swap = prev;
+        prev = curr;
+        curr = swap;
+    }
+    return prev[b.length] ?? 0;
+}
+/**
+ * Suggest a canonical target for an input that did not resolve.
+ *
+ * Two legs, in order, and each closes a case the other cannot:
+ *
+ * - **unique normalised prefix** — carries `clau → claude-code`, which is edit distance 5
+ *   and therefore unreachable by any sane Levenshtein threshold. An input that prefixes
+ *   TWO OR MORE canonical names is AMBIGUOUS and terminates with **no** suggestion
+ *   (`co` → `codex`/`copilot`): guessing between two live targets is worse than a
+ *   round-trip, and the fall-through would otherwise hand `co` to `codex` on a distance
+ *   of 3 — a confident answer to a question the user has not yet decided.
+ * - **Levenshtein ≤ 3, strictly better than the runner-up** — carries the typo case
+ *   `clade-code → claude-code`. A tie yields `null` for the same reason.
+ */
+function suggestTargetName(normalized) {
+    if (normalized.length === 0)
+        return null;
+    const prefixHits = TARGET_NAMES_SORTED.filter((name) => normalizeTargetToken(name).startsWith(normalized));
+    if (prefixHits.length === 1)
+        return prefixHits[0] ?? null;
+    // Ambiguous prefix is TERMINAL, not a fall-through (see doc comment).
+    if (prefixHits.length > 1)
+        return null;
+    let best = null;
+    let bestDistance = Number.POSITIVE_INFINITY;
+    let runnerUpDistance = Number.POSITIVE_INFINITY;
+    for (const name of TARGET_NAMES_SORTED) {
+        const distance = levenshtein(normalized, normalizeTargetToken(name));
+        if (distance < bestDistance) {
+            runnerUpDistance = bestDistance;
+            bestDistance = distance;
+            best = name;
+        }
+        else if (distance < runnerUpDistance) {
+            runnerUpDistance = distance;
+        }
+    }
+    if (best === null)
+        return null;
+    if (bestDistance > TARGET_SUGGESTION_MAX_DISTANCE)
+        return null;
+    // Strictly better than the runner-up — a tie is not a suggestion.
+    if (bestDistance === runnerUpDistance)
+        return null;
+    return best;
+}
+/**
+ * Resolve a user-supplied `--target` value to a canonical {@link TargetName}.
+ *
+ * Total, pure, no I/O. Precedence (fixed and tested):
+ *
+ * 1. exact canonical hit → `{kind:'ok', via:'canonical'}` (`isTargetName` semantics);
+ * 2. normalised canonical hit → `{kind:'ok', via:'alias'}` (`Claude_Code`, `agentsmd`);
+ * 3. explicit {@link TARGET_ALIASES} row → `{kind:'ok', via:'alias'}`;
+ * 4. unique normalised prefix → `{kind:'unknown', suggestion}`;
+ * 5. Levenshtein ≤ 3 strictly better than the runner-up → `{kind:'unknown', suggestion}`;
+ * 6. otherwise → `{kind:'unknown', suggestion:null}`.
+ *
+ * **Aliases ACCEPT; prefix and Levenshtein only SUGGEST.** An alias row is an owner
+ * decision recorded in data; a fuzzy match is a guess, and silently installing to the
+ * wrong target on a guess is worse than one round-trip.
+ */
+export function resolveTargetName(value) {
+    if (isTargetName(value))
+        return { kind: 'ok', target: value, via: 'canonical' };
+    const normalized = normalizeTargetToken(value);
+    for (const name of TARGET_NAMES) {
+        if (normalizeTargetToken(name) === normalized) {
+            return { kind: 'ok', target: name, via: 'alias' };
+        }
+    }
+    const aliased = Object.prototype.hasOwnProperty.call(TARGET_ALIASES, normalized)
+        ? TARGET_ALIASES[normalized]
+        : Object.prototype.hasOwnProperty.call(TARGET_ALIASES, value.trim().toLowerCase())
+            ? TARGET_ALIASES[value.trim().toLowerCase()]
+            : undefined;
+    if (aliased !== undefined)
+        return { kind: 'ok', target: aliased, via: 'alias' };
+    return { kind: 'unknown', input: value, suggestion: suggestTargetName(normalized) };
+}
+/**
+ * Render the two-line failure for an unresolvable `--target`.
+ *
+ * Line 2 keeps the literal substring `--target must be one of:` — three shipped
+ * assertions (`test/cli.test.ts`) pin it, and keeping the shape additive is what makes
+ * the D3 change prove itself with NEW tests instead of rewriting old ones. The values
+ * are {@link TARGET_NAMES_SORTED} (alphabetical), which the pre-change message was not.
+ */
+export function formatTargetProblem(command, resolution) {
+    const suggestion = resolution.suggestion !== null ? ` — did you mean ${JSON.stringify(resolution.suggestion)}?` : '';
+    return [
+        `${command}: unknown --target ${JSON.stringify(resolution.input)}${suggestion}`,
+        `  --target must be one of: ${TARGET_NAMES_SORTED.join(', ')}`,
+    ];
+}
+/** The one-line diagnostic emitted (on stderr) when an alias was accepted. */
+export function formatTargetAliasNote(command, input, target) {
+    return `${command}: --target ${JSON.stringify(input)} → ${target} (alias)`;
+}
 //# sourceMappingURL=targets.js.map

package/dist/targets.js.map

@@ -1 +1 @@
-{"version":3,"file":"targets.js","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAU9D,iFAAiF;AACjF,iFAAiF;AACjF,wEAAwE;AACxE,MAAM,CAAC,MAAM,OAAO,GAAgC;IAClD,aAAa,EAAE,aAAa;IAC5B,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE,eAAe;IACzB,MAAM,EAAE,aAAa;IACrB,UAAU,EAAE,iBAAiB;IAC7B,OAAO,EAAE,cAAc;IACvB,WAAW,EAAE,eAAe;IAC5B,MAAM,EAAE,aAAa;IACrB,MAAM,EAAE,aAAa;IACrB,wEAAwE;IACxE,8EAA8E;IAC9E,QAAQ,EAAE,eAAe;CAC1B,CAAC;AAEF,uCAAuC;AACvC,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAiB,CAAC;AAEjE,0DAA0D;AAC1D,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/harness-core",
-  "version": "0.4.4",
+  "version": "0.5.0",
   "description": "Shared harness logic - skill loading, additive apply, and the init/sync/verify/doctor operations.",
   "type": "module",
   "license": "MIT",
@@ -16,7 +16,8 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
-    }
+    },
+    "./package.json": "./package.json"
   },
   "files": [
     "dist",
@@ -25,28 +26,21 @@
     ".dz-manifest.json",
     "sbom.json"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "lint": "tsc -p tsconfig.json --noEmit"
-  },
   "dependencies": {
-    "@dzhechkov/adapter-agents-md": "workspace:*",
     "@dzhechkov/adapter-claude": "^0.2.0",
     "@dzhechkov/adapter-codex": "^0.2.0",
-    "@dzhechkov/adapter-copilot": "workspace:*",
-    "@dzhechkov/adapter-cursor": "workspace:*",
-    "@dzhechkov/adapter-gemini": "workspace:*",
     "@dzhechkov/adapter-hermes": "^0.2.0",
     "@dzhechkov/adapter-openclaude": "^0.1.0",
     "@dzhechkov/adapter-opencode": "^0.2.0",
-    "@dzhechkov/adapter-windsurf": "workspace:*",
-    "@dzhechkov/core": "workspace:*",
-    "@dzhechkov/memory": "workspace:*",
     "proper-lockfile": "^4.1.2",
-    "yaml": "^2.0.0"
+    "yaml": "^2.0.0",
+    "@dzhechkov/adapter-agents-md": "0.1.1",
+    "@dzhechkov/adapter-cursor": "0.1.1",
+    "@dzhechkov/adapter-gemini": "0.1.1",
+    "@dzhechkov/adapter-windsurf": "0.1.1",
+    "@dzhechkov/adapter-copilot": "0.1.1",
+    "@dzhechkov/core": "0.2.15",
+    "@dzhechkov/memory": "0.2.9"
   },
   "peerDependenciesMeta": {
     "@ruvector/rvf": {
@@ -71,5 +65,12 @@
     "url": "https://github.com/djd1m/dz-harness-hub.git",
     "directory": "packages/@dzhechkov/harness-core"
   },
-  "homepage": "https://github.com/djd1m/dz-harness-hub/tree/main/packages/@dzhechkov/harness-core#readme"
-}
+  "homepage": "https://github.com/djd1m/dz-harness-hub/tree/main/packages/@dzhechkov/harness-core#readme",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  }
+}