@rasensio/aidlc 1.8.1 → 1.9.0

package/dist/compile/limits.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Platform-imposed size budgets for emitted rule files.
+ *
+ * Extracted from the windsurf adapter so operational packaging can enforce the
+ * same per-file ceiling instead of hardcoding a second copy of the number.
+ *
+ * Known limitation (AC-48): `MAX_TOTAL_CHARS` is enforced *within* a single
+ * InstallPlan. Framework and operational emission produce separate plans, so
+ * neither sees the other's contribution to the total. The per-file cap is
+ * enforced for both; the cross-plan total is not.
+ *
+ * @module
+ */
+/** Windsurf per-rule-file character ceiling. */
+export declare const MAX_FILE_CHARS = 6000;
+/** Windsurf total-rules character ceiling across all rule files. */
+export declare const MAX_TOTAL_CHARS = 12000;
+/** Fraction of a ceiling at which a warning is emitted. */
+export declare const TOTAL_WARN_THRESHOLD = 0.85;
+//# sourceMappingURL=limits.d.ts.map

package/dist/compile/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/compile/limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,gDAAgD;AAChD,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,oEAAoE;AACpE,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC,2DAA2D;AAC3D,eAAO,MAAM,oBAAoB,OAAO,CAAC"}

package/dist/compile/limits.js

@@ -0,0 +1,20 @@
+/**
+ * Platform-imposed size budgets for emitted rule files.
+ *
+ * Extracted from the windsurf adapter so operational packaging can enforce the
+ * same per-file ceiling instead of hardcoding a second copy of the number.
+ *
+ * Known limitation (AC-48): `MAX_TOTAL_CHARS` is enforced *within* a single
+ * InstallPlan. Framework and operational emission produce separate plans, so
+ * neither sees the other's contribution to the total. The per-file cap is
+ * enforced for both; the cross-plan total is not.
+ *
+ * @module
+ */
+/** Windsurf per-rule-file character ceiling. */
+export const MAX_FILE_CHARS = 6000;
+/** Windsurf total-rules character ceiling across all rule files. */
+export const MAX_TOTAL_CHARS = 12000;
+/** Fraction of a ceiling at which a warning is emitted. */
+export const TOTAL_WARN_THRESHOLD = 0.85;
+//# sourceMappingURL=limits.js.map

package/dist/compile/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../src/compile/limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,gDAAgD;AAChD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC,oEAAoE;AACpE,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC"}

package/dist/compile/naming.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Shared skill-naming conventions for platform packaging.
+ *
+ * Before this module the five adapters each restated their own naming rules in
+ * a private helper, so framework and operational packaging could drift apart
+ * (AC-34). The helpers were *not* equivalent — they implemented three distinct
+ * behaviours — so this module exposes the behaviour space explicitly rather than
+ * collapsing them into one function and silently changing adapter output:
+ *
+ * | Caller              | Function                  | Behaviour                                   |
+ * |---------------------|---------------------------|---------------------------------------------|
+ * | claude-code, kiro   | `normalizeSkillName`      | substitute, collapse, trim, prefix, truncate |
+ * | windsurf            | `skillSlug`               | lowercase + substitute only                  |
+ * | cursor, codex       | `canonicalSkillFilename`  | pass-through                                 |
+ *
+ * Prefixing is a caller choice, never unconditional (AC-41): framework emission
+ * passes `prefix: true`, operational emission passes `prefix: false`. That is
+ * what lets operational skills stay out of the reserved `aidlc-` namespace
+ * (AC-19) while still reusing these conventions.
+ *
+ * Requirements: AC-19, AC-33, AC-34, AC-41
+ *
+ * @module
+ */
+/** Maximum length for a platform skill directory or file name. */
+export declare const MAX_SKILL_NAME_LENGTH = 64;
+/** The namespace prefix reserved for framework-owned skills. */
+export declare const FRAMEWORK_PREFIX = "aidlc-";
+/** Options controlling how a skill name becomes a path segment. */
+export interface SkillNameOpts {
+    /**
+     * Apply the reserved `aidlc-` framework prefix. Always explicit — an
+     * unconditional prefix is what made AC-19 and AC-34 contradictory (AC-41).
+     */
+    prefix: boolean;
+    /** Collapse runs of hyphens and trim leading/trailing ones. Default true. */
+    collapse?: boolean;
+    /** Truncate to this length. Default `MAX_SKILL_NAME_LENGTH`; 0 disables. */
+    truncate?: number;
+}
+/**
+ * Normalize a skill name into a filesystem-safe path segment.
+ *
+ * This is the claude-code / kiro directory convention: lowercase, non-charset
+ * characters substituted with hyphens, hyphen runs collapsed, ends trimmed,
+ * optionally prefixed, then truncated.
+ *
+ * @param name - Raw skill name.
+ * @param opts - Prefix choice plus optional collapse/truncate overrides.
+ * @returns A lowercase hyphenated segment safe to use as a directory name.
+ */
+export declare function normalizeSkillName(name: string, opts: SkillNameOpts): string;
+/**
+ * Windsurf's weaker slug: lowercase and substitute, but neither collapse nor
+ * truncate nor prefix.
+ *
+ * Deliberately not unified with `normalizeSkillName`. The two agree on every
+ * name shipped today (all are already lowercase-hyphenated), but they diverge on
+ * non-conforming input, and changing windsurf's output would violate AC-33.
+ * `test/golden-adapters-refactor.test.ts` pins the difference.
+ *
+ * @param name - Raw skill name.
+ * @returns A lowercase slug with non-charset characters substituted.
+ */
+export declare function skillSlug(name: string): string;
+/**
+ * The canonical `.aidlc/skills/` filename convention: the skill name verbatim
+ * plus `.md`.
+ *
+ * Used by claude-code, kiro, cursor, and codex. Windsurf routes its canonical
+ * filename through `skillSlug` instead — a pre-existing inconsistency preserved
+ * here rather than fixed, per AC-33.
+ *
+ * @param name - Raw skill name.
+ * @returns `<name>.md`.
+ */
+export declare function canonicalSkillFilename(name: string): string;
+/**
+ * Build a platform rule/file name carrying the framework prefix.
+ *
+ * Several adapters built this prefix inline in a template literal
+ * (`.cursor/rules/aidlc-${name}.mdc`), which meant re-pointing the helpers alone
+ * would have left the convention restated per platform — the drift AC-34 exists
+ * to prevent. Note this reproduces the existing double-prefix for framework
+ * skills (`aidlc-aidlc-overview`), which AC-33 requires us to preserve.
+ *
+ * @param name - Raw skill name (or slug).
+ * @param ext - File extension including the dot, e.g. `.mdc`.
+ * @returns `aidlc-<name><ext>`.
+ */
+export declare function prefixedRuleFilename(name: string, ext: string): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/compile/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../src/compile/naming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,kEAAkE;AAClE,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAQxC,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAEzC,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAmB5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtE"}

package/dist/compile/naming.js

@@ -0,0 +1,105 @@
+/**
+ * Shared skill-naming conventions for platform packaging.
+ *
+ * Before this module the five adapters each restated their own naming rules in
+ * a private helper, so framework and operational packaging could drift apart
+ * (AC-34). The helpers were *not* equivalent — they implemented three distinct
+ * behaviours — so this module exposes the behaviour space explicitly rather than
+ * collapsing them into one function and silently changing adapter output:
+ *
+ * | Caller              | Function                  | Behaviour                                   |
+ * |---------------------|---------------------------|---------------------------------------------|
+ * | claude-code, kiro   | `normalizeSkillName`      | substitute, collapse, trim, prefix, truncate |
+ * | windsurf            | `skillSlug`               | lowercase + substitute only                  |
+ * | cursor, codex       | `canonicalSkillFilename`  | pass-through                                 |
+ *
+ * Prefixing is a caller choice, never unconditional (AC-41): framework emission
+ * passes `prefix: true`, operational emission passes `prefix: false`. That is
+ * what lets operational skills stay out of the reserved `aidlc-` namespace
+ * (AC-19) while still reusing these conventions.
+ *
+ * Requirements: AC-19, AC-33, AC-34, AC-41
+ *
+ * @module
+ */
+/** Maximum length for a platform skill directory or file name. */
+export const MAX_SKILL_NAME_LENGTH = 64;
+/**
+ * The one skill that never takes the `aidlc-` prefix: the bare entry point.
+ * Both prefixing adapters exempt it, so the shared helper must too.
+ */
+const BARE_ENTRY_POINT = 'aidlc';
+/** The namespace prefix reserved for framework-owned skills. */
+export const FRAMEWORK_PREFIX = 'aidlc-';
+/**
+ * Normalize a skill name into a filesystem-safe path segment.
+ *
+ * This is the claude-code / kiro directory convention: lowercase, non-charset
+ * characters substituted with hyphens, hyphen runs collapsed, ends trimmed,
+ * optionally prefixed, then truncated.
+ *
+ * @param name - Raw skill name.
+ * @param opts - Prefix choice plus optional collapse/truncate overrides.
+ * @returns A lowercase hyphenated segment safe to use as a directory name.
+ */
+export function normalizeSkillName(name, opts) {
+    const collapse = opts.collapse ?? true;
+    const truncate = opts.truncate ?? MAX_SKILL_NAME_LENGTH;
+    let normalized = name.toLowerCase().replace(/[^a-z0-9-]/g, '-');
+    if (collapse) {
+        normalized = normalized.replace(/-+/g, '-').replace(/^-|-$/g, '');
+    }
+    if (opts.prefix && normalized !== BARE_ENTRY_POINT && !normalized.startsWith(FRAMEWORK_PREFIX)) {
+        normalized = `${FRAMEWORK_PREFIX}${normalized}`;
+    }
+    if (truncate > 0 && normalized.length > truncate) {
+        normalized = normalized.slice(0, truncate);
+    }
+    return normalized;
+}
+/**
+ * Windsurf's weaker slug: lowercase and substitute, but neither collapse nor
+ * truncate nor prefix.
+ *
+ * Deliberately not unified with `normalizeSkillName`. The two agree on every
+ * name shipped today (all are already lowercase-hyphenated), but they diverge on
+ * non-conforming input, and changing windsurf's output would violate AC-33.
+ * `test/golden-adapters-refactor.test.ts` pins the difference.
+ *
+ * @param name - Raw skill name.
+ * @returns A lowercase slug with non-charset characters substituted.
+ */
+export function skillSlug(name) {
+    return name.toLowerCase().replace(/[^a-z0-9-]/g, '-');
+}
+/**
+ * The canonical `.aidlc/skills/` filename convention: the skill name verbatim
+ * plus `.md`.
+ *
+ * Used by claude-code, kiro, cursor, and codex. Windsurf routes its canonical
+ * filename through `skillSlug` instead — a pre-existing inconsistency preserved
+ * here rather than fixed, per AC-33.
+ *
+ * @param name - Raw skill name.
+ * @returns `<name>.md`.
+ */
+export function canonicalSkillFilename(name) {
+    return `${name}.md`;
+}
+/**
+ * Build a platform rule/file name carrying the framework prefix.
+ *
+ * Several adapters built this prefix inline in a template literal
+ * (`.cursor/rules/aidlc-${name}.mdc`), which meant re-pointing the helpers alone
+ * would have left the convention restated per platform — the drift AC-34 exists
+ * to prevent. Note this reproduces the existing double-prefix for framework
+ * skills (`aidlc-aidlc-overview`), which AC-33 requires us to preserve.
+ *
+ * @param name - Raw skill name (or slug).
+ * @param ext - File extension including the dot, e.g. `.mdc`.
+ * @returns `aidlc-<name><ext>`.
+ */
+export function prefixedRuleFilename(name, ext) {
+    return `${FRAMEWORK_PREFIX}${name}${ext}`;
+}
+//# sourceMappingURL=naming.js.map

package/dist/compile/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../src/compile/naming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,kEAAkE;AAClE,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAExC;;;GAGG;AACH,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEjC,gEAAgE;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAezC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,IAAmB;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,qBAAqB,CAAC;IAExD,IAAI,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAEhE,IAAI,QAAQ,EAAE,CAAC;QACb,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,IAAI,UAAU,KAAK,gBAAgB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/F,UAAU,GAAG,GAAG,gBAAgB,GAAG,UAAU,EAAE,CAAC;IAClD,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QACjD,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,GAAG,IAAI,KAAK,CAAC;AACtB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,GAAW;IAC5D,OAAO,GAAG,gBAAgB,GAAG,IAAI,GAAG,GAAG,EAAE,CAAC;AAC5C,CAAC"}

package/dist/operational/discover.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Discovery and re-emit for operational skills.
+ *
+ * Re-emit (AC-18) exists so a skill can be packaged for a newly added platform
+ * without rewriting it, and so a content-package update can reach skills generated
+ * earlier. It refreshes the machine-managed verification section and
+ * `content_version`, and leaves every user-authored byte alone — which is how
+ * AC-50 is scoped in the design rather than violated.
+ *
+ * Requirements: AC-17, AC-18, AC-36, AC-50
+ *
+ * @module
+ */
+import type { PlatformId } from '../core/types.js';
+import { type OperationalSkill } from './schema.js';
+import { type EmitReport } from './emit.js';
+/** One discovered skill plus where it came from. */
+export interface DiscoveredSkill {
+    skill: OperationalSkill;
+    /** Repo-relative path of the canonical body. */
+    path: string;
+}
+/** A canonical body that exists but could not be parsed. */
+export interface DiscoveryProblem {
+    path: string;
+    reason: string;
+}
+/** Result of scanning the operational-skills directory. */
+export interface DiscoveryResult {
+    skills: DiscoveredSkill[];
+    /** Unparseable files, surfaced as warnings rather than aborting the scan. */
+    problems: DiscoveryProblem[];
+}
+/**
+ * Enumerate canonical operational-skill bodies.
+ *
+ * Matches `*.md` exactly and excludes anything containing `.tmp`, so a staged or
+ * abandoned temp file is never mistaken for a skill.
+ *
+ * @param projectRoot - Absolute project root.
+ * @returns Parsed skills plus any files that failed to parse.
+ */
+export declare function discoverOperationalSkills(projectRoot: string): DiscoveryResult;
+/** Load a single operational skill by name. */
+export declare function loadOperationalSkill(projectRoot: string, name: string): OperationalSkill | null;
+/**
+ * Refresh the machine-managed parts of a skill from the content package.
+ *
+ * Replaces only the bytes between the verify-steps delimiters and updates
+ * `content_version`. When the body has no managed region — a hand-authored file, or
+ * one whose markers were removed — the section is appended rather than silently
+ * skipped, so verification is never absent (AC-35).
+ *
+ * @param skill - The skill to refresh.
+ * @param contentRoot - Content package root.
+ * @param contentVersion - Version to stamp.
+ * @returns A new skill; the input is not mutated.
+ */
+export declare function refreshManagedSections(skill: OperationalSkill, contentRoot: string, contentVersion: string): OperationalSkill;
+/** Options for a re-emit run. */
+export interface ReEmitOptions {
+    projectRoot: string;
+    contentRoot: string;
+    contentVersion: string;
+    platforms: PlatformId[];
+    /** Re-emit only this skill; omit for every discovered skill (AC-18 scope). */
+    name?: string;
+    dryRun?: boolean;
+}
+/** Outcome of a re-emit run. */
+export interface ReEmitResult {
+    /** Names of skills re-emitted. */
+    names: string[];
+    report: EmitReport;
+    problems: DiscoveryProblem[];
+}
+/**
+ * Re-emit one or all operational skills.
+ *
+ * Deliberately overwrites platform-derived files — they are, by definition, this
+ * command's own prior output, which is AC-50's stated exception to AC-10's
+ * no-silent-overwrite rule.
+ *
+ * @param opts - Re-emit options.
+ * @returns Which skills were re-emitted and what changed on disk.
+ * @throws When a named skill does not exist, or a configured platform lacks packaging.
+ */
+export declare function reEmit(opts: ReEmitOptions): ReEmitResult;
+//# sourceMappingURL=discover.d.ts.map

package/dist/operational/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/operational/discover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAM3E,OAAO,EAAiD,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAE3F,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,gBAAgB,CAAC;IACxB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAuB9E;AAED,+CAA+C;AAC/C,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,gBAAgB,GAAG,IAAI,CAIzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,gBAAgB,EACvB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,gBAAgB,CAWlB;AAED,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,gCAAgC;AAChC,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CAkDxD"}

package/dist/operational/discover.js

@@ -0,0 +1,132 @@
+/**
+ * Discovery and re-emit for operational skills.
+ *
+ * Re-emit (AC-18) exists so a skill can be packaged for a newly added platform
+ * without rewriting it, and so a content-package update can reach skills generated
+ * earlier. It refreshes the machine-managed verification section and
+ * `content_version`, and leaves every user-authored byte alone — which is how
+ * AC-50 is scoped in the design rather than violated.
+ *
+ * Requirements: AC-17, AC-18, AC-36, AC-50
+ *
+ * @module
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { OPERATIONAL_DIR, canonicalBodyPath } from './packagers.js';
+import { parseOperationalSkill } from './schema.js';
+import { extractVerifySteps, replaceVerifySection, wrapVerifySection, } from './verify.js';
+import { executePlanStaged, dryRunPlanStaged, planEmit } from './emit.js';
+/**
+ * Enumerate canonical operational-skill bodies.
+ *
+ * Matches `*.md` exactly and excludes anything containing `.tmp`, so a staged or
+ * abandoned temp file is never mistaken for a skill.
+ *
+ * @param projectRoot - Absolute project root.
+ * @returns Parsed skills plus any files that failed to parse.
+ */
+export function discoverOperationalSkills(projectRoot) {
+    const dir = join(projectRoot, OPERATIONAL_DIR);
+    const skills = [];
+    const problems = [];
+    if (!existsSync(dir)) {
+        return { skills, problems };
+    }
+    // Sorted so discovery order — and therefore index content — is deterministic.
+    for (const entry of readdirSync(dir).sort()) {
+        if (!entry.endsWith('.md') || entry.includes('.tmp'))
+            continue;
+        const rel = `${OPERATIONAL_DIR}/${entry}`;
+        try {
+            const skill = parseOperationalSkill(readFileSync(join(dir, entry), 'utf8'));
+            skills.push({ skill, path: rel });
+        }
+        catch (err) {
+            problems.push({ path: rel, reason: err.message });
+        }
+    }
+    return { skills, problems };
+}
+/** Load a single operational skill by name. */
+export function loadOperationalSkill(projectRoot, name) {
+    const abs = join(projectRoot, canonicalBodyPath(name));
+    if (!existsSync(abs))
+        return null;
+    return parseOperationalSkill(readFileSync(abs, 'utf8'));
+}
+/**
+ * Refresh the machine-managed parts of a skill from the content package.
+ *
+ * Replaces only the bytes between the verify-steps delimiters and updates
+ * `content_version`. When the body has no managed region — a hand-authored file, or
+ * one whose markers were removed — the section is appended rather than silently
+ * skipped, so verification is never absent (AC-35).
+ *
+ * @param skill - The skill to refresh.
+ * @param contentRoot - Content package root.
+ * @param contentVersion - Version to stamp.
+ * @returns A new skill; the input is not mutated.
+ */
+export function refreshManagedSections(skill, contentRoot, contentVersion) {
+    const steps = extractVerifySteps(contentRoot);
+    const replaced = replaceVerifySection(skill.body, steps);
+    const body = replaced ?? `${skill.body.replace(/\n+$/, '')}\n\n${wrapVerifySection(steps)}\n`;
+    return {
+        meta: { ...skill.meta, content_version: contentVersion },
+        body,
+    };
+}
+/**
+ * Re-emit one or all operational skills.
+ *
+ * Deliberately overwrites platform-derived files — they are, by definition, this
+ * command's own prior output, which is AC-50's stated exception to AC-10's
+ * no-silent-overwrite rule.
+ *
+ * @param opts - Re-emit options.
+ * @returns Which skills were re-emitted and what changed on disk.
+ * @throws When a named skill does not exist, or a configured platform lacks packaging.
+ */
+export function reEmit(opts) {
+    const { skills: discovered, problems } = discoverOperationalSkills(opts.projectRoot);
+    const targets = opts.name
+        ? discovered.filter((d) => d.skill.meta.name === opts.name)
+        : discovered;
+    if (opts.name && targets.length === 0) {
+        throw new Error(`no operational skill named '${opts.name}' in ${OPERATIONAL_DIR}/` +
+            (problems.length > 0
+                ? ` (${problems.length} file(s) failed to parse — see warnings)`
+                : ''));
+    }
+    // Refresh every target first, so index artifacts describe post-refresh state.
+    const refreshed = targets.map((d) => refreshManagedSections(d.skill, opts.contentRoot, opts.contentVersion));
+    // The full set as it will exist after this run, for index platforms.
+    const byName = new Map(discovered.map((d) => [d.skill.meta.name, d.skill]));
+    for (const s of refreshed)
+        byName.set(s.meta.name, s);
+    const allSkills = [...byName.values()];
+    const filesWritten = [];
+    const filesSkipped = [];
+    const warnings = [];
+    for (const skill of refreshed) {
+        const plan = planEmit({
+            skill,
+            platforms: opts.platforms,
+            projectRoot: opts.projectRoot,
+            allSkills,
+        });
+        const report = opts.dryRun
+            ? dryRunPlanStaged(plan, opts.projectRoot)
+            : executePlanStaged(plan, opts.projectRoot);
+        filesWritten.push(...report.filesWritten);
+        filesSkipped.push(...report.filesSkipped);
+        warnings.push(...report.warnings);
+    }
+    return {
+        names: refreshed.map((s) => s.meta.name),
+        report: { filesWritten, filesSkipped, warnings },
+        problems,
+    };
+}
+//# sourceMappingURL=discover.js.map

package/dist/operational/discover.js.map

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

package/dist/operational/emit.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Operational-skill emission: plan building and staged, all-or-nothing execution.
+ *
+ * Reuses `InstallPlan`/`FileOp` — the same types the framework adapters produce —
+ * which buys skip-if-identical idempotence (NFR-7), dry-run equivalence, and
+ * `mergeBlock` support for codex without touching `SkillMeta` (AC-33).
+ *
+ * `executePlan` writes op-by-op, so a mid-plan failure leaves a partial tree. That
+ * is unacceptable under AC-45 and unrepairable under AC-10's collision refusal, so
+ * emission uses `executePlanStaged` instead: resolve and validate everything,
+ * stage every byte into one scratch directory, then commit by rename.
+ *
+ * Requirements: AC-15, AC-17, AC-45, AC-47, NFR-7
+ *
+ * @module
+ */
+import type { InstallPlan, PlatformId } from '../core/types.js';
+import { type OperationalSkill } from './schema.js';
+/** Inputs for one emission. */
+export interface EmitRequest {
+    /** The skill being emitted (its canonical body is (re)written). */
+    skill: OperationalSkill;
+    /** Platforms from `.aidlc/config.yaml`. */
+    platforms: PlatformId[];
+    /** Absolute project root. */
+    projectRoot: string;
+    /**
+     * Every operational skill in the project, including `skill`. Index platforms
+     * need the full set; per-skill platforms ignore it.
+     */
+    allSkills: OperationalSkill[];
+}
+/** Result of applying (or simulating) an operational plan. */
+export interface EmitReport {
+    filesWritten: string[];
+    filesSkipped: string[];
+    warnings: string[];
+}
+/** Thrown when staging or committing fails. */
+export declare class EmitError extends Error {
+    /** Ops whose rename already completed, when a commit fails part-way. */
+    readonly committed: string[];
+    constructor(reason: string, 
+    /** Ops whose rename already completed, when a commit fails part-way. */
+    committed?: string[]);
+}
+/**
+ * Build the InstallPlan for one operational skill.
+ *
+ * Every packager is resolved **before** any op is produced, so a mixed
+ * supported/unsupported `platforms:` list throws during planning with nothing
+ * staged — AC-47's all-or-nothing guarantee.
+ *
+ * @param req - The emission request.
+ * @returns A plan whose ops cover the canonical body plus every platform artifact.
+ * @throws {UnsupportedPlatformError} When any configured platform lacks packaging.
+ */
+export declare function planEmit(req: EmitRequest): InstallPlan;
+/**
+ * Apply a plan atomically-as-possible.
+ *
+ * Three phases:
+ * 1. **Resolve and validate** — compute final content for every op. Pure. Every
+ *    predictable failure lands here, before a single byte is written.
+ * 2. **Stage** — write each op into one scratch directory outside every path the
+ *    project enumerates. On failure, remove the scratch dir and abort; the tree is
+ *    exactly as it was.
+ * 3. **Commit** — create parent directories, then rename each staged file onto its
+ *    target.
+ *
+ * Honest bound: phase 3 is a rename sequence, not one transaction. A failure there
+ * reports which renames completed, and the residual state is repaired by
+ * `--re-emit`, which is idempotent. Directories this run created are removed on a
+ * phase-3 failure only when still empty.
+ *
+ * Skip-if-identical is preserved, so re-emitting unchanged input writes nothing
+ * (NFR-7, AC-17).
+ *
+ * @param plan - The plan to apply.
+ * @param rootDir - Absolute project root.
+ * @returns What was written and skipped.
+ */
+export declare function executePlanStaged(plan: InstallPlan, rootDir: string): EmitReport;
+/**
+ * Simulate `executePlanStaged` without touching the filesystem.
+ *
+ * Uses the same resolution, so `--dry-run` is provably equivalent to a real run.
+ *
+ * @param plan - The plan to simulate.
+ * @param rootDir - Absolute project root.
+ */
+export declare function dryRunPlanStaged(plan: InstallPlan, rootDir: string): EmitReport;
+//# sourceMappingURL=emit.d.ts.map

package/dist/operational/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../src/operational/emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAYH,OAAO,KAAK,EAAU,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAIxE,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAM/E,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,KAAK,EAAE,gBAAgB,CAAC;IACxB,2CAA2C;IAC3C,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,8DAA8D;AAC9D,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,+CAA+C;AAC/C,qBAAa,SAAU,SAAQ,KAAK;IAGhC,wEAAwE;aACxD,SAAS,EAAE,MAAM,EAAE;gBAFnC,MAAM,EAAE,MAAM;IACd,wEAAwE;IACxD,SAAS,GAAE,MAAM,EAAO;CAK3C;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CA4CtD;AA6BD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CA6EhF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAgB/E"}