@devtrack-solution/codesdd 1.2.2 → 1.2.3

package/dist/core/sdd/state.js

@@ -2,10 +2,11 @@ import path from 'node:path';
 import { promises as fs } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
-import { resolveOpenSpecLiveSubpath } from './services/legacy-capability.service.js';
+import { resolveLegacySpecLiveSubpath } from './services/legacy-capability.service.js';
 import { ArchitectureStateSchema, BacklogStateSchema, DiscoveryIndexStateSchema, FinalizeQueueStateSchema, IntegrationContractsStateSchema, FrontendDecisionsStateSchema, UnblockEventsStateSchema, TransitionLogStateSchema, AuditHistoryStateSchema, FrontendGapsStateSchema, FrontendMapStateSchema, RepoMapStateSchema, SourceIndexStateSchema, SkillCatalogStateSchema, SkillRoutingStateSchema, ServiceCatalogStateSchema, TechStackStateSchema, TechDebtStateSchema, NamingContractStateSchema, } from './types.js';
 import { CLI_NAME } from '../branding.js';
-import { DEFAULT_CURATED_SKILL_CATALOG, BUILT_IN_SDD_SKILLS, buildCuratedBundlesMarkdown, } from './default-skills.js';
+import { CURRENT_SDD_STATE_VERSION, buildSddContractConfig } from './contract.js';
+import { DEFAULT_CURATED_SKILL_CATALOG, BUILT_IN_SDD_SKILLS, buildCuratedBundlesMarkdown, buildCuratedBundlesCurationData, } from './default-skills.js';
 import { buildSddInternalReadme, PROMPT_00_COMECE_POR_AQUI_MD, PROMPT_01_INGESTAO_DEPOSITO_MD, PROMPT_02_NORMALIZAR_PLANEJAMENTO_MD, PROMPT_03_EXECUCAO_FEATURE_MD, PROMPT_04_CONSOLIDACAO_FINALIZE_MD, PROMPTS_README_MD, TEMPLATE_1_SPEC_MD, TEMPLATE_2_PLAN_MD, TEMPLATE_QUALITY_MD, TEMPLATE_3_TASKS_MD, TEMPLATE_4_CHANGELOG_MD, } from './default-bootstrap-files.js';
 import { SddWriteTransaction } from './transaction.js';
 const LEGACY_LAYOUT_FOLDERS = {
@@ -38,13 +39,13 @@ const PT_BR_LAYOUT_FOLDERS = {
     active: 'execucao',
     archived: 'arquivados',
 };
-function skillSubfoldersForLayout(layout) {
+export function skillSubfoldersForLayout(layout) {
     if (layout === 'pt-BR') {
         return { curated: 'skills', bundles: 'pacotes' };
     }
     return { curated: 'curated', bundles: 'bundles' };
 }
-function defaultFoldersForLayout(layout) {
+export function defaultFoldersForLayout(layout) {
     if (layout === 'pt-BR') {
         return { ...PT_BR_LAYOUT_FOLDERS };
     }
@@ -95,10 +96,10 @@ const CANONICAL_FOLDER_OPTIONS = {
         archived: ['arquivados'],
     },
 };
-function isRecord(value) {
+export function isRecord(value) {
     return !!value && typeof value === 'object' && !Array.isArray(value);
 }
-function mergeRuntimeConfig(raw) {
+export function mergeRuntimeConfig(raw) {
     if (!isRecord(raw)) {
         return {
             ...DEFAULT_SDD_CONFIG,
@@ -163,7 +164,7 @@ function mergeRuntimeConfig(raw) {
         },
     };
 }
-function validateRuntimeConfig(config) {
+export function validateRuntimeConfig(config) {
     const allowed = CANONICAL_FOLDER_OPTIONS[config.layout];
     const invalidEntries = Object.entries(config.folders).flatMap(([key, value]) => {
         const folderKey = key;
@@ -179,7 +180,7 @@ function validateRuntimeConfig(config) {
         throw new Error(`Configuracao SDD invalida em .sdd/config.yaml: folders fora do canonico para layout ${config.layout}: ${invalidEntries.join('; ')}`);
     }
 }
-function defaultRuntimeConfig() {
+export function defaultRuntimeConfig() {
     return {
         ...DEFAULT_SDD_CONFIG,
         folders: { ...DEFAULT_SDD_CONFIG.folders },
@@ -187,7 +188,7 @@ function defaultRuntimeConfig() {
         views: { autoRender: DEFAULT_SDD_CONFIG.views.autoRender },
     };
 }
-async function fileExists(filePath) {
+export async function fileExists(filePath) {
     try {
         await fs.access(filePath);
         return true;
@@ -199,7 +200,7 @@ async function fileExists(filePath) {
 async function ensureDir(dirPath) {
     await fs.mkdir(dirPath, { recursive: true });
 }
-async function firstExistingFile(paths) {
+export async function firstExistingFile(paths) {
     for (const filePath of paths) {
         if (await fileExists(filePath)) {
             return filePath;
@@ -207,17 +208,27 @@ async function firstExistingFile(paths) {
     }
     return null;
 }
-async function readYamlObject(filePath) {
+export async function readYamlObject(filePath) {
     const parsed = parseYaml(await fs.readFile(filePath, 'utf-8'));
     return isRecord(parsed) ? parsed : {};
 }
-function buildSddConfigDocument(existing, config) {
+const LEGACY_GENERATED_BY_PREFIXES = [`${'open'}sdd`, `${'open'}spec`];
+export function isLegacyGeneratedBy(value) {
+    if (typeof value !== 'string')
+        return false;
+    return LEGACY_GENERATED_BY_PREFIXES.some((prefix) => new RegExp(`^${prefix}\\s`, 'i').test(value));
+}
+export function buildSddConfigDocument(existing, config) {
     const next = { ...existing };
     delete next.sdd;
     next.version = typeof next.version === 'number' ? next.version : 1;
-    next.state_version = typeof next.state_version === 'number' ? next.state_version : 2;
+    const stateVersion = typeof next.state_version === 'number' ? next.state_version : CURRENT_SDD_STATE_VERSION;
+    next.state_version = stateVersion;
+    if (stateVersion >= CURRENT_SDD_STATE_VERSION) {
+        next.sdd_contract = buildSddContractConfig();
+    }
     next.generatedBy =
-        typeof next.generatedBy === 'string' && !next.generatedBy.startsWith('openspec ')
+        typeof next.generatedBy === 'string' && !isLegacyGeneratedBy(next.generatedBy)
             ? next.generatedBy
             : `${CLI_NAME} sdd init`;
     next.meta_evolution = isRecord(next.meta_evolution)
@@ -237,10 +248,10 @@ function buildSddConfigDocument(existing, config) {
     next.views = { autoRender: config.views.autoRender };
     return next;
 }
-async function removeSddRuntimeConfigFromOpenSpecConfig(projectRoot) {
+export async function removeSddRuntimeConfigFromLegacySpecConfig(projectRoot) {
     const legacyConfigPath = await firstExistingFile([
-        resolveOpenSpecLiveSubpath(projectRoot, 'config.yaml'),
-        resolveOpenSpecLiveSubpath(projectRoot, 'config.yml'),
+        resolveLegacySpecLiveSubpath(projectRoot, 'config.yaml'),
+        resolveLegacySpecLiveSubpath(projectRoot, 'config.yml'),
     ]);
     if (!legacyConfigPath) {
         return;
@@ -263,8 +274,8 @@ export async function loadProjectSddConfig(projectRoot) {
         return config;
     }
     const legacyConfigPath = await firstExistingFile([
-        resolveOpenSpecLiveSubpath(projectRoot, 'config.yaml'),
-        resolveOpenSpecLiveSubpath(projectRoot, 'config.yml'),
+        resolveLegacySpecLiveSubpath(projectRoot, 'config.yaml'),
+        resolveLegacySpecLiveSubpath(projectRoot, 'config.yml'),
     ]);
     if (legacyConfigPath) {
         const legacyRoot = await readYamlObject(legacyConfigPath);
@@ -289,8 +300,8 @@ export async function upsertProjectSddConfig(projectRoot, overrides) {
     }
     else {
         const legacyConfigPath = await firstExistingFile([
-            resolveOpenSpecLiveSubpath(projectRoot, 'config.yaml'),
-            resolveOpenSpecLiveSubpath(projectRoot, 'config.yml'),
+            resolveLegacySpecLiveSubpath(projectRoot, 'config.yaml'),
+            resolveLegacySpecLiveSubpath(projectRoot, 'config.yml'),
         ]);
         if (legacyConfigPath) {
             const legacyRoot = await readYamlObject(legacyConfigPath);
@@ -310,7 +321,7 @@ export async function upsertProjectSddConfig(projectRoot, overrides) {
     }
     validateRuntimeConfig(mergedSdd);
     await fs.writeFile(configPath, stringifyYaml(buildSddConfigDocument(rootConfig, mergedSdd)), 'utf-8');
-    await removeSddRuntimeConfigFromOpenSpecConfig(projectRoot);
+    await removeSddRuntimeConfigFromLegacySpecConfig(projectRoot);
     return mergedSdd;
 }
 export function resolveSddPaths(projectRoot, config) {
@@ -431,13 +442,13 @@ async function writeFileIfMissing(filePath, content) {
     await fs.mkdir(path.dirname(filePath), { recursive: true });
     await fs.writeFile(filePath, content, 'utf-8');
 }
-function isBuiltInSkillSourceTree(definition) {
+export function isBuiltInSkillSourceTree(definition) {
     return (typeof definition === 'object' &&
         definition !== null &&
         'kind' in definition &&
         definition.kind === 'source-tree');
 }
-function adaptSkillContentForLayout(content, paths, config) {
+export function adaptSkillContentForLayout(content, paths, config) {
     if (config.layout === 'en-US') {
         return content;
     }
@@ -450,7 +461,7 @@ function adaptSkillContentForLayout(content, paths, config) {
         .replaceAll('/attachments/', '/anexos/')
         .replaceAll('/legacy/', '/legado/');
 }
-async function listTreeFiles(rootDir) {
+export async function listTreeFiles(rootDir) {
     async function walk(currentDir, relativePrefix) {
         const entries = await fs.readdir(currentDir, { withFileTypes: true });
         const files = [];
@@ -474,7 +485,7 @@ async function listTreeFiles(rootDir) {
     files.sort((a, b) => a.localeCompare(b));
     return files;
 }
-async function resolveBuiltInSourceRoot(paths, sourceRoot) {
+export async function resolveBuiltInSourceRoot(paths, sourceRoot) {
     const normalized = sourceRoot.trim();
     if (!normalized) {
         return null;
@@ -495,7 +506,7 @@ async function resolveBuiltInSourceRoot(paths, sourceRoot) {
     }
     return null;
 }
-async function materializeBuiltInSkill(paths, config, skillId, definition) {
+export async function materializeBuiltInSkill(paths, config, skillId, definition) {
     if (typeof definition === 'string') {
         const materializedContent = adaptSkillContentForLayout(definition, paths, config);
         await writeFileIfMissing(path.join(paths.skillsCuratedDir, skillId, 'SKILL.md'), materializedContent);
@@ -523,7 +534,7 @@ async function materializeBuiltInSkill(paths, config, skillId, definition) {
         await writeFileIfMissing(targetFile, adaptSkillContentForLayout(content, paths, config));
     }
 }
-async function ensureCuratedSkillCatalog(filePath) {
+export async function ensureCuratedSkillCatalog(filePath) {
     if (!(await fileExists(filePath))) {
         await fs.writeFile(filePath, stringifyYaml(DEFAULT_CURATED_SKILL_CATALOG), 'utf-8');
         return;
@@ -573,7 +584,8 @@ async function ensureCuratedSkillCatalog(filePath) {
 export async function ensureBaseFiles(paths, config) {
     await writeYamlIfMissing(paths.configFile, {
         version: 1,
-        state_version: 2,
+        state_version: CURRENT_SDD_STATE_VERSION,
+        sdd_contract: buildSddContractConfig(),
         generatedBy: `${CLI_NAME} sdd init`,
         meta_evolution: {
             enabled: true,
@@ -615,8 +627,8 @@ export async function ensureBaseFiles(paths, config) {
         version: 1,
         default_skills: ['architecture', 'concise-planning', 'context-window-management'],
         routes: [
-            { domain: 'backend', skills: ['architecture', 'api-design-principles'], bundles: [] },
-            { domain: 'api', skills: ['api-design-principles', 'api-clean-flask-langgraph'], bundles: ['python-agentic-backend'] },
+            { domain: 'backend', skills: ['devtrack-api', 'architecture', 'api-design-principles'], bundles: ['architecture-backend'] },
+            { domain: 'api', skills: ['devtrack-api', 'api-design-principles'], bundles: ['architecture-backend'] },
             { domain: 'python', skills: ['api-clean-flask-langgraph', 'architecture'], bundles: ['python-agentic-backend'] },
             { domain: 'flask', skills: ['api-clean-flask-langgraph'], bundles: ['python-agentic-backend'] },
             { domain: 'nestjs', skills: ['devtrack-api', 'architecture'], bundles: ['architecture-backend'] },
@@ -642,6 +654,11 @@ export async function ensureBaseFiles(paths, config) {
         prompts: 'prompts',
     }));
     await writeFileIfMissing(path.join(paths.skillsBundlesDir, config.layout === 'en-US' ? 'curation-en-us.md' : 'curadoria-pt-br.md'), buildCuratedBundlesMarkdown());
+    // EPIC-0072 wave 1 (FEAT-0284) — emit a schema-validated YAML form alongside
+    // the Markdown view so consumers can read typed data without scraping headings.
+    // The .md remains the human-readable view; the .yaml is the structured contract.
+    const curationLayout = config.layout === 'pt-BR' ? 'pt-BR' : 'en-US';
+    await writeFileIfMissing(path.join(paths.skillsBundlesDir, config.layout === 'en-US' ? 'curation-en-us.yaml' : 'curadoria-pt-br.yaml'), stringifyYaml(buildCuratedBundlesCurationData(curationLayout)));
     for (const [skillId, definition] of Object.entries(BUILT_IN_SDD_SKILLS)) {
         await materializeBuiltInSkill(paths, config, skillId, definition);
     }
@@ -711,8 +728,8 @@ export async function loadStateSnapshot(paths, config) {
             version: 1,
             default_skills: ['architecture', 'concise-planning', 'context-window-management'],
             routes: [
-                { domain: 'backend', skills: ['architecture', 'api-design-principles'], bundles: [] },
-                { domain: 'api', skills: ['api-design-principles', 'api-clean-flask-langgraph'], bundles: ['python-agentic-backend'] },
+                { domain: 'backend', skills: ['devtrack-api', 'architecture', 'api-design-principles'], bundles: ['architecture-backend'] },
+                { domain: 'api', skills: ['devtrack-api', 'api-design-principles'], bundles: ['architecture-backend'] },
                 { domain: 'python', skills: ['api-clean-flask-langgraph', 'architecture'], bundles: ['python-agentic-backend'] },
                 { domain: 'flask', skills: ['api-clean-flask-langgraph'], bundles: ['python-agentic-backend'] },
                 { domain: 'nestjs', skills: ['devtrack-api', 'architecture'], bundles: ['architecture-backend'] },
@@ -814,6 +831,14 @@ export function defaultNamingContractState() {
         '.sdd/discovery/**',
         'test/core/sdd/fixtures/**',
     ];
+    const legacyPrefix = 'open';
+    const legacySpec = `${legacyPrefix}spec`;
+    const legacySdd = `${legacyPrefix}sdd`;
+    const legacyTitlePrefix = `${legacyPrefix[0].toUpperCase()}${legacyPrefix.slice(1)}`;
+    const legacySpecTitle = `${legacyTitlePrefix}Spec`;
+    const legacySddTitle = `${legacyTitlePrefix}SDD`;
+    const legacySpecCamel = `${legacyPrefix}Spec`;
+    const legacySddCamel = `${legacyPrefix}SDD`;
     return {
         version: 1,
         product_name: 'CodeSDD',
@@ -830,13 +855,13 @@ export function defaultNamingContractState() {
             package_name: '@devtrack-solution/codesdd',
         },
         forbidden_terms: [
-            { term: 'openspec', scope: 'all', severity: 'warning', allowlist_paths: [...sharedAllowlist] },
-            { term: 'OpenSpec', scope: 'all', severity: 'warning', allowlist_paths: [...sharedAllowlist] },
-            { term: 'openSpec', scope: 'all', severity: 'warning', allowlist_paths: [...sharedAllowlist] },
+            { term: legacySpec, scope: 'all', severity: 'warning', allowlist_paths: [...sharedAllowlist] },
+            { term: legacySpecTitle, scope: 'all', severity: 'warning', allowlist_paths: [...sharedAllowlist] },
+            { term: legacySpecCamel, scope: 'all', severity: 'warning', allowlist_paths: [...sharedAllowlist] },
         ],
         allowlist: [
             { path_pattern: '.sdd/archived/**', reason: 'Archived SDD artifacts retain legacy terminology', owner: 'sdd-core' },
-            { path_pattern: '.sdd/sources/legacy/spec-corpus/**', reason: 'Legacy OpenSpec import sources', owner: 'sdd-core' },
+            { path_pattern: '.sdd/sources/legacy/spec-corpus/**', reason: 'Imported legacy corpus sources', owner: 'sdd-core' },
             { path_pattern: 'node_modules/**', reason: 'Third-party dependencies', owner: 'sdd-core' },
             { path_pattern: 'dist/**', reason: 'Build output', owner: 'sdd-core' },
             { path_pattern: 'coverage/**', reason: 'Test coverage artifacts', owner: 'sdd-core' },
@@ -844,7 +869,7 @@ export function defaultNamingContractState() {
         ],
         rename_rules: [
             {
-                from: 'OpenSDD',
+                from: legacySddTitle,
                 to: 'CodeSDD',
                 scope: 'all',
                 phase: 'identity-introduction',
@@ -853,7 +878,7 @@ export function defaultNamingContractState() {
                 path_globs: ['README.md', 'docs/**', 'src/**', 'test/**', '.sdd/state/**'],
             },
             {
-                from: 'opensdd',
+                from: legacySdd,
                 to: 'codesdd',
                 scope: 'all',
                 phase: 'identity-introduction',
@@ -862,7 +887,7 @@ export function defaultNamingContractState() {
                 path_globs: ['package.json', 'bin/**', 'src/**', 'test/**', 'docs/**'],
             },
             {
-                from: '@devtrack-solution/codesdd',
+                from: `@devtrack-solution/${legacySdd}-cli`,
                 to: '@devtrack-solution/codesdd',
                 scope: 'all',
                 phase: 'package-identity',
@@ -874,7 +899,7 @@ export function defaultNamingContractState() {
         zero_residue_gate: {
             enabled: true,
             enforcement: 'warning',
-            terms: ['openspec', 'OpenSpec', 'openSpec', 'opensdd', 'OpenSDD', 'openSDD'],
+            terms: [legacySpec, legacySpecTitle, legacySpecCamel, legacySdd, legacySddTitle, legacySddCamel],
             allowlist_paths: [...sharedAllowlist],
             removal_phase: 'compatibility-shutdown',
         },

package/dist/core/sdd/structural-health.d.ts

@@ -34,26 +34,26 @@ export declare const StructuralFindingSeveritySchema: z.ZodEnum<{
 }>;
 export declare const StructuralFindingCategorySchema: z.ZodEnum<{
     metadata: "metadata";
+    integrity: "integrity";
+    naming: "naming";
+    references: "references";
     lifecycle: "lifecycle";
     render: "render";
-    references: "references";
-    integrity: "integrity";
     boundary: "boundary";
-    naming: "naming";
 }>;
 export declare const StructuralSanitizerDispositionSchema: z.ZodEnum<{
+    blocked: "blocked";
     manual: "manual";
     safe: "safe";
-    blocked: "blocked";
     noop: "noop";
 }>;
 export declare const StructuralLifecycleStateTokenSchema: z.ZodEnum<{
     done: "done";
+    ready: "ready";
+    blocked: "blocked";
     planned: "planned";
     in_progress: "in_progress";
     archived: "archived";
-    blocked: "blocked";
-    ready: "ready";
 }>;
 export declare const StructuralNavigationNodeKindSchema: z.ZodEnum<{
     epic: "epic";
@@ -102,17 +102,17 @@ export declare const StructuralTokenRegistrySchema: z.ZodObject<{
     }>>;
     finding_categories: z.ZodArray<z.ZodEnum<{
         metadata: "metadata";
+        integrity: "integrity";
+        naming: "naming";
+        references: "references";
         lifecycle: "lifecycle";
         render: "render";
-        references: "references";
-        integrity: "integrity";
         boundary: "boundary";
-        naming: "naming";
     }>>;
     sanitizer_dispositions: z.ZodArray<z.ZodEnum<{
+        blocked: "blocked";
         manual: "manual";
         safe: "safe";
-        blocked: "blocked";
         noop: "noop";
     }>>;
 }, z.core.$strip>;
@@ -139,8 +139,8 @@ export declare const StructuralCommandInvocationSchema: z.ZodObject<{
     }>;
     mode: z.ZodEnum<{
         apply: "apply";
-        dry_run: "dry_run";
         read: "read";
+        dry_run: "dry_run";
     }>;
     args: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
@@ -149,12 +149,12 @@ export declare const StructuralFindingSchema: z.ZodObject<{
     rule_id: z.ZodString;
     category: z.ZodEnum<{
         metadata: "metadata";
+        integrity: "integrity";
+        naming: "naming";
+        references: "references";
         lifecycle: "lifecycle";
         render: "render";
-        references: "references";
-        integrity: "integrity";
         boundary: "boundary";
-        naming: "naming";
     }>;
     severity: z.ZodEnum<{
         error: "error";
@@ -167,9 +167,9 @@ export declare const StructuralFindingSchema: z.ZodObject<{
     location: z.ZodOptional<z.ZodString>;
     sanitizer: z.ZodObject<{
         disposition: z.ZodEnum<{
+            blocked: "blocked";
             manual: "manual";
             safe: "safe";
-            blocked: "blocked";
             noop: "noop";
         }>;
         reason: z.ZodString;
@@ -186,12 +186,12 @@ export declare const StructuralDiagnosticReportSchema: z.ZodObject<{
         rule_id: z.ZodString;
         category: z.ZodEnum<{
             metadata: "metadata";
+            integrity: "integrity";
+            naming: "naming";
+            references: "references";
             lifecycle: "lifecycle";
             render: "render";
-            references: "references";
-            integrity: "integrity";
             boundary: "boundary";
-            naming: "naming";
         }>;
         severity: z.ZodEnum<{
             error: "error";
@@ -204,9 +204,9 @@ export declare const StructuralDiagnosticReportSchema: z.ZodObject<{
         location: z.ZodOptional<z.ZodString>;
         sanitizer: z.ZodObject<{
             disposition: z.ZodEnum<{
+                blocked: "blocked";
                 manual: "manual";
                 safe: "safe";
-                blocked: "blocked";
                 noop: "noop";
             }>;
             reason: z.ZodString;
@@ -223,12 +223,12 @@ export declare const StructuralDiagnosticReportSchema: z.ZodObject<{
         }> & z.core.$partial, z.ZodNumber>>;
         by_category: z.ZodDefault<z.ZodRecord<z.ZodEnum<{
             metadata: "metadata";
+            integrity: "integrity";
+            naming: "naming";
+            references: "references";
             lifecycle: "lifecycle";
             render: "render";
-            references: "references";
-            integrity: "integrity";
             boundary: "boundary";
-            naming: "naming";
         }> & z.core.$partial, z.ZodNumber>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
@@ -236,18 +236,18 @@ export declare const StructuralSanitizerActionSchema: z.ZodObject<{
     action_id: z.ZodString;
     finding_id: z.ZodString;
     disposition: z.ZodEnum<{
+        blocked: "blocked";
         manual: "manual";
         safe: "safe";
-        blocked: "blocked";
         noop: "noop";
     }>;
     operation: z.ZodEnum<{
+        skip: "skip";
         mkdir: "mkdir";
         render: "render";
         move: "move";
         register: "register";
         manual_review: "manual_review";
-        skip: "skip";
     }>;
     from_path: z.ZodOptional<z.ZodString>;
     to_path: z.ZodOptional<z.ZodString>;
@@ -270,24 +270,24 @@ export declare const StructuralSanitizerTransactionOperationSchema: z.ZodObject<
     action_id: z.ZodString;
     finding_id: z.ZodString;
     disposition: z.ZodEnum<{
+        blocked: "blocked";
         manual: "manual";
         safe: "safe";
-        blocked: "blocked";
         noop: "noop";
     }>;
     operation: z.ZodEnum<{
+        skip: "skip";
         mkdir: "mkdir";
         render: "render";
         move: "move";
         register: "register";
         manual_review: "manual_review";
-        skip: "skip";
     }>;
     status: z.ZodEnum<{
-        skipped: "skipped";
-        failed: "failed";
         applied: "applied";
         rolled_back: "rolled_back";
+        failed: "failed";
+        skipped: "skipped";
     }>;
     from_path: z.ZodOptional<z.ZodString>;
     to_path: z.ZodOptional<z.ZodString>;
@@ -325,24 +325,24 @@ export declare const StructuralSanitizerTransactionManifestSchema: z.ZodObject<{
         action_id: z.ZodString;
         finding_id: z.ZodString;
         disposition: z.ZodEnum<{
+            blocked: "blocked";
             manual: "manual";
             safe: "safe";
-            blocked: "blocked";
             noop: "noop";
         }>;
         operation: z.ZodEnum<{
+            skip: "skip";
             mkdir: "mkdir";
             render: "render";
             move: "move";
             register: "register";
             manual_review: "manual_review";
-            skip: "skip";
         }>;
         status: z.ZodEnum<{
-            skipped: "skipped";
-            failed: "failed";
             applied: "applied";
             rolled_back: "rolled_back";
+            failed: "failed";
+            skipped: "skipped";
         }>;
         from_path: z.ZodOptional<z.ZodString>;
         to_path: z.ZodOptional<z.ZodString>;
@@ -382,18 +382,18 @@ export declare const StructuralSanitizerReportSchema: z.ZodObject<{
         action_id: z.ZodString;
         finding_id: z.ZodString;
         disposition: z.ZodEnum<{
+            blocked: "blocked";
             manual: "manual";
             safe: "safe";
-            blocked: "blocked";
             noop: "noop";
         }>;
         operation: z.ZodEnum<{
+            skip: "skip";
             mkdir: "mkdir";
             render: "render";
             move: "move";
             register: "register";
             manual_review: "manual_review";
-            skip: "skip";
         }>;
         from_path: z.ZodOptional<z.ZodString>;
         to_path: z.ZodOptional<z.ZodString>;
@@ -403,18 +403,18 @@ export declare const StructuralSanitizerReportSchema: z.ZodObject<{
         action_id: z.ZodString;
         finding_id: z.ZodString;
         disposition: z.ZodEnum<{
+            blocked: "blocked";
             manual: "manual";
             safe: "safe";
-            blocked: "blocked";
             noop: "noop";
         }>;
         operation: z.ZodEnum<{
+            skip: "skip";
             mkdir: "mkdir";
             render: "render";
             move: "move";
             register: "register";
             manual_review: "manual_review";
-            skip: "skip";
         }>;
         from_path: z.ZodOptional<z.ZodString>;
         to_path: z.ZodOptional<z.ZodString>;
@@ -444,11 +444,11 @@ export declare const StructuralLifecycleEntrySchema: z.ZodObject<{
     }>>;
     state_token: z.ZodEnum<{
         done: "done";
+        ready: "ready";
+        blocked: "blocked";
         planned: "planned";
         in_progress: "in_progress";
         archived: "archived";
-        blocked: "blocked";
-        ready: "ready";
     }>;
 }, z.core.$strip>;
 export declare const StructuralDirectoryStateMappingSchema: z.ZodObject<{
@@ -459,19 +459,19 @@ export declare const StructuralDirectoryStateMappingSchema: z.ZodObject<{
         archived: "archived";
     }>, z.ZodArray<z.ZodEnum<{
         done: "done";
+        ready: "ready";
+        blocked: "blocked";
         planned: "planned";
         in_progress: "in_progress";
         archived: "archived";
-        blocked: "blocked";
-        ready: "ready";
     }>>>;
     state_to_root: z.ZodRecord<z.ZodEnum<{
         done: "done";
+        ready: "ready";
+        blocked: "blocked";
         planned: "planned";
         in_progress: "in_progress";
         archived: "archived";
-        blocked: "blocked";
-        ready: "ready";
     }>, z.ZodEnum<{
         active: "active";
         planned: "planned";