@devtrack-solution/codesdd 1.2.2 → 1.2.4-rc3

package/dist/core/sdd/default-bootstrap-files.js

@@ -25,6 +25,8 @@ This directory stores the project's operational memory.
 10. \`${memoryDir}/core/frontend-decisions.md\` (when frontend is enabled)
 
 ## How To Operate
+CodeSDD is the official planner for initialized repositories. Any request that implies implementation, file edits, validation, execution, or finalize implicitly requires the CodeSDD flow unless the user explicitly marks it as read-only or outside CodeSDD.
+
 1. Run \`${CLI_NAME} sdd onboard system\` to understand current state.
 2. Run \`${CLI_NAME} sdd next\` to see what can start now.
 3. Run \`${CLI_NAME} sdd start <FEAT-ID>\` only when the item is not already active.
@@ -40,7 +42,7 @@ This directory stores the project's operational memory.
 - \`${planning}/frontend-auditoria.md\`: frontend coverage audit by FEAT.
 - \`state/\`: canonical YAML source of truth.
 - \`${skills}/\`: local curation and bundles.
-- \`${templates}/\`: base templates for spec, plan, quality, tasks, and changelog.
+- \`${templates}/\`: base YAML templates for spec, plan, quality, tasks, and changelog.
 - \`${prompts}/\`: recommended prompts for common workflows.
 - \`${active}/\`: active FEAT workspaces.
 - \`${archived}/\`: finalized frozen workspaces.
@@ -50,6 +52,7 @@ This directory stores the project's operational memory.
 - \`state/*.yaml\` is the only canonical operational state for planning, dependencies, blockers, progress, quality, and handoff.
 - \`core/*.md\` and \`${planning}/*.md\` are operational views derived from canonical state.
 - External context, memory, workflow, backlog, scratchpad, or handoff stores are not authoritative.
+- Agent-native plans and other planners may only refine execution after \`${CLI_NAME} sdd next\` and \`${CLI_NAME} sdd context <FEAT-ID>\` bind the request to a CodeSDD FEAT.
 
 ## Operational Rule
 Every completed feature must update relevant documentation before \`finalize\`.
@@ -80,11 +83,12 @@ In the terminal, from your project directory:
 \`\`\`bash
 codesdd install --tools none --lang en-US --layout en-US
 codesdd sdd init --frontend --lang en-US --layout en-US
-codesdd sdd init-context
+codesdd sdd init-context --frontend --lang en-US --layout en-US
 codesdd sdd check --render
 codesdd sdd rebuild --from-disk --dry-run
 codesdd sdd dedup --apply --dry-run
 codesdd sdd onboard system
+codesdd reload --tools none --lang en-US --layout en-US
 \`\`\`
 
 ## 2) Understand The Main Folders
@@ -97,6 +101,7 @@ codesdd sdd onboard system
 - \`.sdd/archived/\`: finalized workspaces.
 
 CodeSDD is the only operational memory for the project. Do not use external context, memory, workflow, backlog, scratchpad, or handoff stores as active project state.
+In initialized CodeSDD repositories, requests that imply implementation, edits, validation, execution, or finalize implicitly require CodeSDD planning unless explicitly marked read-only or outside CodeSDD.
 
 ## 3) I Have PRDs, Wireframes, Or Stories. What Now?
 
@@ -207,14 +212,16 @@ Objective:
 Execute a FEAT without losing traceability.
 
 Instructions:
-1. Run \`codesdd sdd context FEAT-0001\`.
-2. Update \`.sdd/active/FEAT-0001/\` (spec, plan, tasks, changelog).
-3. Implement.
-4. Update \`.sdd/active/FEAT-0001/5-quality.yaml\` with evidence or a formal exception; quality contracts are blocking by default.
-5. Update affected canonical docs.
-6. Declare frontend impact with \`codesdd sdd frontend-impact FEAT-0001 ...\`.
-7. Ensure architectural-impact FEATs have an ADR before finalize.
-8. Finish with \`codesdd sdd finalize --ref FEAT-0001\`.
+1. Treat implementation, edit, validation, execution, and finalize requests as requiring CodeSDD planning unless the user explicitly marks the request as read-only or outside CodeSDD.
+2. Run \`codesdd sdd next\` and bind the work to the active or ready FEAT returned by CodeSDD.
+3. Run \`codesdd sdd context FEAT-0001\`.
+4. Update \`.sdd/active/FEAT-0001/\` (spec, plan, tasks, changelog).
+5. Implement.
+6. Update \`.sdd/active/FEAT-0001/5-quality.yaml\` with evidence or a formal exception; quality contracts are blocking by default.
+7. Update affected canonical docs.
+8. Declare frontend impact with \`codesdd sdd frontend-impact FEAT-0001 ...\`.
+9. Ensure architectural-impact FEATs have an ADR before finalize.
+10. Finish with \`codesdd sdd finalize --ref FEAT-0001\`.
 `;
 export const PROMPT_04_CONSOLIDACAO_FINALIZE_MD = `# Prompt: Consolidation And Finalize
 
@@ -314,6 +321,39 @@ traceability:
     spec_updated_at: ""
     changelog_refs: []
   requirements: []
+q95_ledger:
+  threshold: 95
+  score: 0
+  status: pending
+  computed_at: ""
+  weights:
+    coverage: 30
+    traceability: 20
+    integrity: 20
+    naming: 10
+    token: 20
+  axes:
+    coverage:
+      raw_score: 0
+      weighted_score: 0
+      rationale: Computed during finalize.
+    traceability:
+      raw_score: 0
+      weighted_score: 0
+      rationale: Computed during finalize.
+    integrity:
+      raw_score: 0
+      weighted_score: 0
+      rationale: Computed during finalize.
+    naming:
+      raw_score: 0
+      weighted_score: 0
+      rationale: Computed during finalize.
+    token:
+      raw_score: 0
+      weighted_score: 0
+      rationale: Computed during finalize.
+  next_best_action: Record missing evidence to raise the lowest weighted axis.
 security_integrity:
   endpoint_auth_review: pending
   sensitive_data_exposure_review: pending

package/dist/core/sdd/default-skills.d.ts

@@ -5,11 +5,41 @@ export interface BuiltInSkillSourceTree {
 }
 export type BuiltInSkillTree = Record<string, string>;
 export type BuiltInSkillDefinition = string | BuiltInSkillTree | BuiltInSkillSourceTree;
+export declare function normalizeSkillManifestContent(content: string): string;
+export declare function computeSkillManifestSha256(content: string): string;
 export declare const DEFAULT_CURATED_SKILL_CATALOG: SkillCatalogState;
 export declare const SOURCE_INTAKE_SDD_SKILL_MD = "---\nname: source-intake-sdd\ndescription: Reads the .sdd/sources folder, indexes raw sources, and classifies project intake material.\n---\n\n# Source Intake SDD\n\nUse this skill when the project has raw material in `.sdd/sources/`.\n\n## Objective\n\nTurn a heterogeneous document set into a traceable operational inventory.\n\n## Where To Look\n\n- `.sdd/sources/prds/`\n- `.sdd/sources/rfcs/`\n- `.sdd/sources/briefings/`\n- `.sdd/sources/stories/`\n- `.sdd/sources/wireframes/`\n- `.sdd/sources/html-mocks/`\n- `.sdd/sources/visual-references/`\n- `.sdd/sources/interviews/`\n- `.sdd/sources/attachments/`\n- `.sdd/sources/legacy/`\n\n## Required Flow\n\n1. List existing sources.\n2. Classify each source by type.\n3. Register/update `.sdd/state/source-index.yaml`.\n4. Fill for each item:\n   - `type`\n   - `path`\n   - `title`\n   - `status`\n   - `summary`\n   - `used_by`\n   - `consolidation_targets`\n5. Do not generate backlog directly in this step.\n\n## Golden Rule\n\n- Raw source is not canonical source.\n- The goal here is inventory and classification.\n- Backlog is created only after semantic normalization.\n";
 export declare const BUSINESS_EXTRACTOR_SDD_SKILL_MD = "---\nname: business-extractor-sdd\ndescription: Extracts stories, business rules, actors, integrations, and constraints from source material.\n---\n\n# Business Extractor SDD\n\nUse this skill when the repository already has PRDs, briefings, stories, or consolidated documents.\n\n## Expected Outputs\n\n- canonical context updates:\n  - `.sdd/state/architecture.yaml`\n  - `.sdd/state/service-catalog.yaml`\n  - `.sdd/state/tech-stack.yaml`\n  - `.sdd/state/integration-contracts.yaml`\n- suggestions for:\n  - EPICs\n  - FEATs\n  - INSIGHTs only when real ambiguity exists\n\n## How To Decide The Destination\n\n- If the excerpt describes system structure, consolidate it into context.\n- If the excerpt is a large approved decision, normalize it into an EPIC.\n- If the excerpt is already clear and executable, normalize it into a FEAT.\n- If the excerpt is ambiguous, contradictory, or incomplete, normalize it into an INSIGHT.\n\n## Do Not\n\n- Do not turn an entire PRD into a direct task list.\n- Do not invent technical details that are not present in the source.\n";
 export declare const FRONTEND_EXTRACTOR_SDD_SKILL_MD = "---\nname: frontend-extractor-sdd\ndescription: Extracts frontend surfaces, routes, components, gaps, and decisions from images, HTML, wireframes, and references.\n---\n\n# Frontend Extractor SDD\n\nUse this skill when visual inspiration or UI/UX definitions exist in `.sdd/sources/`.\n\n## Accepted Sources\n\n- wireframes\n- screenshots\n- reference images\n- mocked HTML\n- stories with interface impact\n\n## Expected Outputs\n\n- `.sdd/state/frontend-map.yaml`\n- `.sdd/state/frontend-gaps.yaml`\n- `.sdd/state/frontend-decisions.yaml`\n\n## Classification Criteria\n\n- What is clearly defined as a screen/route goes into frontend-map.\n- What is missing but necessary to cover the journey goes into frontend-gaps.\n- UX rationale, navigation, layout, patterns, and inspiration go into frontend-decisions.\n- If a surface is well-defined and executable, it can become a FEAT.\n";
 export declare const PLANNING_NORMALIZER_SDD_SKILL_MD = "---\nname: planning-normalizer-sdd\ndescription: Converts extracted source material into the SDD operational backlog, prioritizing context, EPICs, and FEATs.\n---\n\n# Planning Normalizer SDD\n\nUse this skill after inventorying sources and extracting business/frontend context.\n\n## Mission\n\nTurn consolidated knowledge into operational SDD artifacts.\n\n## Normalization Order\n\n1. canonical context\n2. EPICs\n3. FEATs\n4. INSIGHTs only for exceptions\n\n## Rules\n\n- Do not force debate when the source is already consolidated and unambiguous.\n- Use debate only for uncertainty, conflict, ambiguity, or open architecture options.\n- Connect FEATs with `blocked_by`, `lock_domains`, `produces`, and `consumes` when enough evidence exists.\n- Record in `.sdd/state/source-index.yaml` which sources generated each EPIC/FEAT.\n\n## Minimum Result\n\nAt the end, the agent must be able to answer:\n- what is system context;\n- what is already approved for planning;\n- what can enter execution now.\n";
+/**
+ * Build the structured YAML form of the curated bundles document.
+ * Mirrors the data shown by `buildCuratedBundlesMarkdown` but emits a
+ * schema-validated object suitable for programmatic consumption.
+ *
+ * Introduced by EPIC-0072 wave 1 (FEAT-0284) as the toolchain precursor
+ * for the broader frontmatter migration. The shape is governed by
+ * `src/core/sdd/skill-bundles-curation-schema.ts`.
+ */
+export declare function buildCuratedBundlesCurationData(layout?: 'en-US' | 'pt-BR'): {
+    schema_version: 1;
+    layout: 'en-US' | 'pt-BR';
+    generated_from: 'CURATED_BUNDLES';
+    objective: string[];
+    bundles: Array<{
+        id: string;
+        title: string;
+        skill_ids: string[];
+    }>;
+    highlighted: Array<{
+        skill_id: string;
+        bundle_id: string;
+        canonical_path: string;
+        notes: string[];
+    }>;
+    canonical_source: string;
+    operational_rule: string[];
+};
 export declare function buildCuratedBundlesMarkdown(): string;
 export declare const REPO_CONTEXT_BOOTSTRAP_SKILL_MD: string;
 export declare const BUILT_IN_SDD_SKILLS: Record<string, BuiltInSkillDefinition>;

package/dist/core/sdd/default-skills.js

@@ -1,24 +1,89 @@
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { CLI_NAME } from '../branding.js';
+import { DEVTRACK_API_APPLIANCE_PLUGIN_ID } from './devtrack-api-appliance.js';
 const DEFAULT_TOOLS = ['codex', 'cursor', 'claude', 'gemini'];
+const DEVTRACK_PORTABLE_TOOLS = ['codex', 'cursor', 'claude', 'gemini', 'kimi', 'opencode'];
+const DEVTRACK_API_DOMAINS = ['architecture', 'backend', 'api', 'nestjs', 'typeorm', 'devtrack', 'foundation'];
+const DEVTRACK_ANGULAR_DOMAINS = [
+    'admin',
+    'angular-admin',
+    'backoffice',
+    'operational-ui',
+    'dashboard',
+    'crud',
+    'data-grid',
+    'admin-forms',
+    'admin-formly',
+    'admin-state',
+    'ngxs-admin',
+    'permissions',
+    'reports',
+    'workflow',
+    'admin-realtime',
+    'admin-chat',
+];
+const DEVTRACK_FLUTTER_DOMAINS = [
+    'flutter',
+    'dart',
+    'cross-platform',
+    'flutter-ui',
+    'flutter-layout',
+    'flutter-routing',
+    'flutter-l10n',
+    'flutter-http',
+    'flutter-json',
+    'widget-preview',
+    'widget-test',
+    'integration-test',
+    'go-router',
+    'arb',
+    'l10n',
+];
 const DEFAULT_SOURCE_REPO = 'https://github.com/sickn33/antigravity-awesome-skills';
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../../');
 const LOCAL_SDD_SKILL_PATHS = {
     'api-clean-flask-langgraph': '.sdd/skills/curated/api-clean-flask-langgraph/SKILL.md',
     'devtrack-api': '.sdd/skills/curated/devtrack-api/SKILL.md',
+    'devtrack-angular': '.sdd/skills/curated/devtrack-angular/SKILL.md',
+    'devtrack-flutter': '.sdd/skills/curated/devtrack-flutter/SKILL.md',
     'source-intake-sdd': '.sdd/skills/curated/source-intake-sdd/SKILL.md',
     'business-extractor-sdd': '.sdd/skills/curated/business-extractor-sdd/SKILL.md',
     'frontend-extractor-sdd': '.sdd/skills/curated/frontend-extractor-sdd/SKILL.md',
     'planning-normalizer-sdd': '.sdd/skills/curated/planning-normalizer-sdd/SKILL.md',
     'mobile-design': '.sdd/skills/curated/sdd-curated-mobile-design/SKILL.md',
+    'sdd-reverse-orchestrator': '.sdd/skills/curated/sdd-reverse-orchestrator/SKILL.md',
+    'sdd-reverse-surface-scout': '.sdd/skills/curated/sdd-reverse-surface-scout/SKILL.md',
+    'sdd-reverse-module-archaeologist': '.sdd/skills/curated/sdd-reverse-module-archaeologist/SKILL.md',
+    'sdd-reverse-business-rules-detective': '.sdd/skills/curated/sdd-reverse-business-rules-detective/SKILL.md',
+    'sdd-reverse-spec-writer': '.sdd/skills/curated/sdd-reverse-spec-writer/SKILL.md',
+    'sdd-reverse-domain-essence-extractor': '.sdd/skills/curated/sdd-reverse-domain-essence-extractor/SKILL.md',
+    'sdd-offdev-docs-orchestrator': '.sdd/skills/curated/sdd-offdev-docs-orchestrator/SKILL.md',
+    'sdd-offdev-docs-mapper': '.sdd/skills/curated/sdd-offdev-docs-mapper/SKILL.md',
+    'sdd-offdev-docs-analyst': '.sdd/skills/curated/sdd-offdev-docs-analyst/SKILL.md',
+    'sdd-reverse-forward-planner': '.sdd/skills/curated/sdd-reverse-forward-planner/SKILL.md',
+    'sdd-reverse-migration-planner': '.sdd/skills/curated/sdd-reverse-migration-planner/SKILL.md',
+    'sdd-reverse-reconstructor': '.sdd/skills/curated/sdd-reverse-reconstructor/SKILL.md',
 };
 const SKILL_METADATA_OVERRIDES = {
     'api-clean-flask-langgraph': {
         title: 'API Clean Flask LangGraph',
-        description: 'Canonical Python/Flask agentic backend skill with Clean Architecture boundaries, tenant/security authority-source rules, OpenSDD decision support (runtime-safe), production-readiness guidance, and maintainable quality gates.',
+        description: 'Canonical Python/Flask agentic backend skill with Clean Architecture boundaries, tenant/security authority-source rules, CodeSDD decision support (runtime-safe), production-readiness guidance, and maintainable quality gates.',
     },
     'devtrack-api': {
         title: 'DevTrack API',
         description: 'Model-agnostic backend engineering and governance skill for DevTrack APIs using NestJS, TypeORM, DDD/Clean Architecture boundaries, evidence-based validation, and safe operational delivery.',
     },
+    'devtrack-angular': {
+        title: 'DevTrack Angular Admin',
+        description: 'Portable Angular Admin engineering and governance skill for DevTrack backoffice surfaces using pages-first architecture, standalone components, lazy admin routes, official Angular skills mapping, Formly, NGXS, data grids, permissions, adapters, accessibility, and multi-agent delivery.',
+    },
+    'devtrack-flutter': {
+        title: 'DevTrack Flutter',
+        description: 'Portable Flutter/Dart engineering and governance skill for DevTrack apps using layered architecture, MVVM/ViewModels, repositories, services, go_router, ARB/l10n, http, JSON mapping, responsive layout, previews, tests, and multi-agent delivery.',
+    },
 };
 const CURATED_BUNDLES = [
     {
@@ -83,6 +148,8 @@ const CURATED_BUNDLES = [
         domains: ['frontend', 'product'],
         phases: ['plan', 'execute', 'verify'],
         skillIds: [
+            'devtrack-angular',
+            'devtrack-flutter',
             'frontend-design',
             'react-best-practices',
             'react-patterns',
@@ -149,6 +216,42 @@ const CURATED_BUNDLES = [
             'incident-responder',
         ],
     },
+    {
+        id: 'reverse-engineering',
+        title: 'Reverse Engineering',
+        domains: ['reverse-engineering', 'legacy', 'discovery'],
+        phases: ['discover', 'plan', 'execute', 'verify'],
+        skillIds: [
+            'sdd-reverse-orchestrator',
+            'sdd-reverse-surface-scout',
+            'sdd-reverse-module-archaeologist',
+            'sdd-reverse-business-rules-detective',
+            'sdd-reverse-spec-writer',
+            'sdd-reverse-domain-essence-extractor',
+        ],
+    },
+    {
+        id: 'off-development-docs',
+        title: 'Off-Development Docs',
+        domains: ['documentation', 'legacy', 'discovery'],
+        phases: ['discover', 'plan', 'verify', 'finalize'],
+        skillIds: [
+            'sdd-offdev-docs-orchestrator',
+            'sdd-offdev-docs-mapper',
+            'sdd-offdev-docs-analyst',
+        ],
+    },
+    {
+        id: 'migration-and-forward',
+        title: 'Migration and Forward',
+        domains: ['migration', 'legacy', 'architecture'],
+        phases: ['plan', 'execute', 'verify', 'finalize'],
+        skillIds: [
+            'sdd-reverse-forward-planner',
+            'sdd-reverse-migration-planner',
+            'sdd-reverse-reconstructor',
+        ],
+    },
 ];
 function titleFromSkillId(skillId) {
     return skillId
@@ -160,23 +263,102 @@ function priorityForIndex(index) {
     const priority = 10 - index;
     return priority < 6 ? 6 : priority;
 }
+function priorityForSkill(skillId, index) {
+    if (skillId === 'devtrack-api' || skillId === 'devtrack-angular' || skillId === 'devtrack-flutter') {
+        return 10;
+    }
+    return priorityForIndex(index);
+}
+export function normalizeSkillManifestContent(content) {
+    return content
+        .replaceAll('.sdd/deposito', '.sdd/sources')
+        .replaceAll('/historias/', '/stories/')
+        .replaceAll('/referencias-visuais/', '/visual-references/')
+        .replaceAll('/entrevistas/', '/interviews/')
+        .replaceAll('/anexos/', '/attachments/')
+        .replaceAll('/legado/', '/legacy/');
+}
+export function computeSkillManifestSha256(content) {
+    return createHash('sha256').update(normalizeSkillManifestContent(content), 'utf-8').digest('hex');
+}
+function fallbackSkillMarkdown(entry) {
+    const domainLine = entry.domains.length > 0 ? entry.domains.join(', ') : 'geral';
+    const phaseLine = entry.phases.length > 0 ? entry.phases.join(', ') : 'all';
+    return `---
+name: ${entry.id}
+description: ${entry.description || entry.title}
+---
+
+# ${entry.title}
+
+## Contexto
+- Dominios: ${domainLine}
+- Fases: ${phaseLine}
+
+## Instrucoes
+${entry.description || 'Aplicar esta skill como apoio especializado durante o planejamento e execucao.'}
+`;
+}
+function seedIntegrityHash(entry) {
+    if (entry.source_path?.startsWith('.sdd/skills/')) {
+        const sourceFile = path.resolve(PACKAGE_ROOT, entry.source_path);
+        if (existsSync(sourceFile)) {
+            return computeSkillManifestSha256(readFileSync(sourceFile, 'utf-8'));
+        }
+    }
+    return computeSkillManifestSha256(fallbackSkillMarkdown(entry));
+}
+function toolsForSkill(skillId) {
+    return skillId === 'devtrack-api' || skillId === 'devtrack-angular' || skillId === 'devtrack-flutter'
+        ? DEVTRACK_PORTABLE_TOOLS
+        : DEFAULT_TOOLS;
+}
+function domainsForSkill(bundle, skillId) {
+    if (skillId === 'devtrack-api') {
+        return DEVTRACK_API_DOMAINS;
+    }
+    if (skillId === 'devtrack-angular') {
+        return DEVTRACK_ANGULAR_DOMAINS;
+    }
+    if (skillId === 'devtrack-flutter') {
+        return DEVTRACK_FLUTTER_DOMAINS;
+    }
+    return bundle.domains;
+}
 function buildSkillEntry(bundle, skillId, index) {
     const localSourcePath = LOCAL_SDD_SKILL_PATHS[skillId];
     const isLocalSkill = Boolean(localSourcePath);
     const metadata = SKILL_METADATA_OVERRIDES[skillId] || {};
-    return {
+    const sourceRepo = isLocalSkill ? 'local://CodeSDD/sdd' : DEFAULT_SOURCE_REPO;
+    const sourcePath = isLocalSkill ? localSourcePath : `skills/${skillId}/SKILL.md`;
+    const deterministicPair = skillId === 'devtrack-api'
+        ? { plugin_id: DEVTRACK_API_APPLIANCE_PLUGIN_ID, capability: 'scaffold.project' }
+        : undefined;
+    const baseEntry = {
         id: skillId,
-        source_repo: isLocalSkill ? 'local://opensdd/sdd' : DEFAULT_SOURCE_REPO,
-        source_path: isLocalSkill ? localSourcePath : `skills/${skillId}/SKILL.md`,
+        source_repo: sourceRepo,
+        source_path: sourcePath,
         title: metadata.title || titleFromSkillId(skillId),
         description: metadata.description || (isLocalSkill
             ? `Native SDD skill for ${bundle.title.toLowerCase()}.`
             : `Curated skill for ${bundle.title.toLowerCase()} in the SDD flow.`),
         phases: bundle.phases,
-        domains: bundle.domains,
-        tools: DEFAULT_TOOLS,
+        domains: domainsForSkill(bundle, skillId),
+        tools: toolsForSkill(skillId),
         bundle_ids: [bundle.id],
-        priority: priorityForIndex(index),
+        priority: priorityForSkill(skillId, index),
+        token_budget: {
+            input_max: 12000,
+            output_max: 4000,
+            thinking_max: 2000,
+        },
+        deterministic_pair: deterministicPair,
+        deprecated_at: undefined,
+        superseded_by: undefined,
+    };
+    return {
+        ...baseEntry,
+        integrity_hash: seedIntegrityHash(baseEntry),
     };
 }
 export const DEFAULT_CURATED_SKILL_CATALOG = {
@@ -332,6 +514,89 @@ At the end, the agent must be able to answer:
 - what is already approved for planning;
 - what can enter execution now.
 `;
+/**
+ * Build the structured YAML form of the curated bundles document.
+ * Mirrors the data shown by `buildCuratedBundlesMarkdown` but emits a
+ * schema-validated object suitable for programmatic consumption.
+ *
+ * Introduced by EPIC-0072 wave 1 (FEAT-0284) as the toolchain precursor
+ * for the broader frontmatter migration. The shape is governed by
+ * `src/core/sdd/skill-bundles-curation-schema.ts`.
+ */
+export function buildCuratedBundlesCurationData(layout = 'en-US') {
+    const objective = layout === 'en-US'
+        ? [
+            'Reduce the 900+ skill universe to a practical set.',
+            'Accelerate planning, execution, and validation.',
+            'Make delegation between agents easier in English.',
+        ]
+        : [
+            'Reduzir o universo de 900+ skills para um conjunto pratico.',
+            'Acelerar planejamento, execucao e validacao.',
+            'Facilitar a delegacao entre agentes em portugues.',
+        ];
+    const bundles = CURATED_BUNDLES.map((bundle) => ({
+        id: bundle.id,
+        title: bundle.title,
+        skill_ids: [...bundle.skillIds],
+    }));
+    const highlighted = [
+        {
+            skill_id: 'api-clean-flask-langgraph',
+            bundle_id: 'python-agentic-backend',
+            canonical_path: '.sdd/skills/curated/api-clean-flask-langgraph/SKILL.md',
+            notes: [
+                'Canonical local reference for Python/Flask Clean Architecture, CodeSDD decision support (without runtime dependency), production-readiness guidance, and quality gates.',
+            ],
+        },
+        {
+            skill_id: 'devtrack-api',
+            bundle_id: 'architecture-backend',
+            canonical_path: '.sdd/skills/curated/devtrack-api/',
+            notes: [
+                'Canonical directory for the DevTrack API skill; includes agents/ and references/.',
+                'Operational default: API/backend work uses devtrack-api unless an explicit skill/profile overrides it; Python/Flask API work uses api-clean-flask-langgraph.',
+            ],
+        },
+        {
+            skill_id: 'devtrack-angular',
+            bundle_id: 'frontend-product',
+            canonical_path: '.sdd/skills/curated/devtrack-angular/',
+            notes: [
+                'Canonical directory for the DevTrack Angular Admin skill; includes agents/ and references/.',
+                'Operational default: Angular Admin/backoffice work that names admin pages, dashboards, CRUD, data grids, admin Formly, admin NGXS/state, official Angular framework patterns, permissions, reports, workflow, admin realtime, or admin chat should use devtrack-angular unless an explicit skill/profile overrides it.',
+            ],
+        },
+        {
+            skill_id: 'devtrack-flutter',
+            bundle_id: 'frontend-product',
+            canonical_path: '.sdd/skills/curated/devtrack-flutter/',
+            notes: [
+                'Canonical directory for the DevTrack Flutter skill; includes agents/ and references/.',
+                'Operational default: Flutter/Dart work that names Flutter apps, widgets, routing, localization, responsive layout, JSON, HTTP, previews, widget tests, integration tests, go_router, ARB, or l10n should use devtrack-flutter unless an explicit skill/profile overrides it.',
+            ],
+        },
+    ];
+    const operational_rule = layout === 'en-US'
+        ? [
+            'The skills in this document are a curation reference.',
+            'Official skills and bundles state must be edited only in canonical YAML.',
+        ]
+        : [
+            'As skills neste documento sao uma referencia de curadoria.',
+            'O estado oficial de skills e bundles deve ser editado apenas no YAML canonico.',
+        ];
+    return {
+        schema_version: 1,
+        layout,
+        generated_from: 'CURATED_BUNDLES',
+        objective,
+        bundles,
+        highlighted,
+        canonical_source: '.sdd/state/skill-catalog.yaml',
+        operational_rule,
+    };
+}
 export function buildCuratedBundlesMarkdown() {
     const lines = [
         '# Skill Curation (en-US)',
@@ -351,10 +616,17 @@ export function buildCuratedBundlesMarkdown() {
     });
     lines.push('## Highlighted Local Skill');
     lines.push('- `api-clean-flask-langgraph` belongs to bundle `python-agentic-backend`.');
-    lines.push('- It is the canonical local reference for Python/Flask Clean Architecture, OpenSDD decision support (without runtime dependency), production-readiness guidance, and quality gates.');
+    lines.push('- It is the canonical local reference for Python/Flask Clean Architecture, CodeSDD decision support (without runtime dependency), production-readiness guidance, and quality gates.');
     lines.push('- Canonical file: `.sdd/skills/curated/api-clean-flask-langgraph/SKILL.md`.');
     lines.push('- `devtrack-api` belongs to bundle `architecture-backend`.');
     lines.push('- Canonical directory: `.sdd/skills/curated/devtrack-api/` (includes `agents/` and `references/`).');
+    lines.push('- Operational default: API/backend work uses `devtrack-api` unless an explicit skill/profile overrides it; Python/Flask API work uses `api-clean-flask-langgraph`.');
+    lines.push('- `devtrack-angular` belongs to bundle `frontend-product` as the Angular Admin/backoffice skill.');
+    lines.push('- Canonical directory: `.sdd/skills/curated/devtrack-angular/` (includes `agents/` and `references/`).');
+    lines.push('- Operational default: Angular Admin/backoffice work that names admin pages, dashboards, CRUD, data grids, admin Formly, admin NGXS/state, official Angular framework patterns, permissions, reports, workflow, admin realtime, or admin chat should use `devtrack-angular` unless an explicit skill/profile overrides it.');
+    lines.push('- `devtrack-flutter` belongs to bundle `frontend-product` as the Flutter/Dart product skill.');
+    lines.push('- Canonical directory: `.sdd/skills/curated/devtrack-flutter/` (includes `agents/` and `references/`).');
+    lines.push('- Operational default: Flutter/Dart work that names Flutter apps, widgets, routing, localization, responsive layout, JSON, HTTP, previews, widget tests, integration tests, go_router, ARB, or l10n should use `devtrack-flutter` unless an explicit skill/profile overrides it.');
     lines.push('');
     lines.push('## Canonical Source');
     lines.push('- `.sdd/state/skill-catalog.yaml`');
@@ -423,5 +695,13 @@ export const BUILT_IN_SDD_SKILLS = {
         kind: 'source-tree',
         sourceRoot: '.sdd/skills/curated/devtrack-api',
     },
+    'devtrack-angular': {
+        kind: 'source-tree',
+        sourceRoot: '.sdd/skills/curated/devtrack-angular',
+    },
+    'devtrack-flutter': {
+        kind: 'source-tree',
+        sourceRoot: '.sdd/skills/curated/devtrack-flutter',
+    },
 };
 //# sourceMappingURL=default-skills.js.map

package/dist/core/sdd/devtrack-api-appliance.d.ts

@@ -0,0 +1,91 @@
+import { type PluginArtifactManifest, type PluginRuntimeInvocationPlan } from './plugin-broker.js';
+import { type PluginManifest } from './plugin-manifest.js';
+import type { PluginArtifactKind, PluginArtifactMapEntry, PluginArtifactRole } from './plugin-sdk-contract.js';
+export declare const DEVTRACK_API_APPLIANCE_PLUGIN_ID = "codesdd-plugin-devtrack-api";
+export declare const DEVTRACK_API_APPLIANCE_CAPABILITIES: readonly ["scaffold.project", "generate.domain", "generate.crud", "validate.structure", "evidence.emit"];
+declare const DEVTRACK_API_SCAFFOLD_CAPABILITY = "scaffold.project";
+type DevTrackApiScaffoldLayer = 'root' | 'application' | 'domain' | 'infrastructure' | 'presentation' | 'shared' | 'tests' | 'docs' | 'config' | 'sdd' | 'assets';
+export interface DevTrackApiScaffoldArtifact {
+    path: string;
+    layer: DevTrackApiScaffoldLayer;
+    operation: 'planned';
+    artifact_kind: PluginArtifactKind;
+    role: PluginArtifactRole;
+    content_type: string;
+    reason: string;
+    source_reference: string;
+    language?: PluginArtifactMapEntry['language'];
+    implementation: PluginArtifactMapEntry['implementation'];
+    decision_refs: string[];
+    tags: string[];
+}
+export interface DevTrackApiScaffoldDryRunInput {
+    feature_ref: string;
+    project_name: string;
+    package_name?: string;
+    created_at?: string;
+    operation_id?: string;
+    requested_write_scope?: string[];
+}
+export interface DevTrackApiScaffoldEvidenceManifest {
+    schema_version: 1;
+    operation_id: string;
+    generated_at: string;
+    feature_ref: string;
+    plugin_ref: {
+        id: string;
+        version: string;
+    };
+    capability: typeof DEVTRACK_API_SCAFFOLD_CAPABILITY;
+    status: 'planned';
+    project_name: string;
+    package_name: string;
+    foundation_reference: {
+        repository: string;
+        architecture_doc: string;
+        derived_structure_doc: string;
+        skill_ref: string;
+    };
+    validation_commands: Array<{
+        command: string;
+        status: 'pending';
+    }>;
+    quality_gates: string[];
+}
+export type DevTrackApiScaffoldDryRunPlan = {
+    schema_version: 1;
+    status: 'planned';
+    created_at: string;
+    operation_id: string;
+    project_name: string;
+    package_name: string;
+    runtime_plan: PluginRuntimeInvocationPlan;
+    artifacts: DevTrackApiScaffoldArtifact[];
+    artifact_manifest: PluginArtifactManifest;
+    evidence_manifest: DevTrackApiScaffoldEvidenceManifest;
+    issues: [];
+} | {
+    schema_version: 1;
+    status: 'invalid' | 'blocked' | 'unresolved';
+    created_at: string;
+    operation_id?: string;
+    project_name: string;
+    package_name: string;
+    runtime_plan?: PluginRuntimeInvocationPlan;
+    artifacts: [];
+    issues: string[];
+};
+export interface DevTrackApiApplianceConformance {
+    valid: boolean;
+    plugin_id: string;
+    capability_names: string[];
+    missing_capabilities: string[];
+    missing_artifact_writes: string[];
+    missing_forbidden_writes: string[];
+    typeorm_only: boolean;
+    issues: string[];
+}
+export declare function evaluateDevTrackApiApplianceConformance(manifest: PluginManifest): DevTrackApiApplianceConformance;
+export declare function buildDevTrackApiScaffoldDryRunPlan(manifest: PluginManifest, input: DevTrackApiScaffoldDryRunInput): DevTrackApiScaffoldDryRunPlan;
+export {};
+//# sourceMappingURL=devtrack-api-appliance.d.ts.map