@specatlas/core 0.1.6 → 0.1.8

package/dist/{approvals-HCBC7QDM.js → approvals-4QHIT7F6.js}

@@ -1,6 +1,6 @@
 import {
   signApproval
-} from "./chunk-2BFXQ65Q.js";
+} from "./chunk-LMJURGRU.js";
 import "./chunk-5RKNY2ZC.js";
 export {
   signApproval

package/dist/{chunk-2BFXQ65Q.js → chunk-LMJURGRU.js}

@@ -78,6 +78,7 @@ var changeMetaSchema = z.object({
   risk: z.enum(["low", "medium", "high"]).optional(),
   created: z.string().optional(),
   owner: z.string().optional(),
+  mockups: z.enum(["required", "skip"]).optional(),
   tracker: z.object({ provider: z.string(), id: z.string() }).optional(),
   paused: z.object({ reason: z.string(), at: z.string(), by: z.string() }).optional(),
   lane_history: z.array(z.object({ from: z.enum(["fix", "standard", "full"]), to: z.enum(["fix", "standard", "full"]), at: z.string(), by: z.string() })).optional(),
@@ -107,6 +108,7 @@ function parseChangeMeta(raw, filePath) {
   if (v.risk !== void 0) meta.risk = v.risk;
   if (v.created !== void 0) meta.created = v.created;
   if (v.owner !== void 0) meta.owner = v.owner;
+  if (v.mockups !== void 0) meta.mockups = v.mockups;
   if (v.tracker !== void 0) meta.tracker = v.tracker;
   if (v.paused !== void 0) meta.paused = v.paused;
   if (v.lane_history !== void 0) meta.laneHistory = v.lane_history;

package/dist/index.d.ts

@@ -143,6 +143,7 @@ interface ChangeMeta {
     risk?: RiskLevel;
     created?: string;
     owner?: string;
+    mockups?: 'required' | 'skip';
     tracker?: {
         provider: string;
         id: string;
@@ -618,6 +619,7 @@ declare const changeMetaSchema: z.ZodObject<{
     risk: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
     created: z.ZodOptional<z.ZodString>;
     owner: z.ZodOptional<z.ZodString>;
+    mockups: z.ZodOptional<z.ZodEnum<["required", "skip"]>>;
     tracker: z.ZodOptional<z.ZodObject<{
         provider: z.ZodString;
         id: z.ZodString;
@@ -682,6 +684,7 @@ declare const changeMetaSchema: z.ZodObject<{
         id: string;
         provider: string;
     } | undefined;
+    mockups?: "required" | "skip" | undefined;
     domain?: string | undefined;
     title?: string | undefined;
     risk?: "low" | "medium" | "high" | undefined;
@@ -712,6 +715,7 @@ declare const changeMetaSchema: z.ZodObject<{
         provider: string;
     } | undefined;
     schema_version?: number | undefined;
+    mockups?: "required" | "skip" | undefined;
     domain?: string | undefined;
     title?: string | undefined;
     lane?: "fix" | "standard" | "full" | undefined;
@@ -860,7 +864,7 @@ declare function planWaves(tasks: TasksFile, opts?: {
 }): WavePlan;
 declare function planBlock(block: TaskBlock, maxParallel: number): BlockWavePlan;
 
-type ChangeState = 'draft' | 'spec_draft' | 'awaiting_approval' | 'approved' | 'planned' | 'building' | 'built' | 'verified' | 'ready' | 'archived';
+type ChangeState = 'draft' | 'spec_draft' | 'awaiting_mockups' | 'awaiting_approval' | 'approved' | 'planned' | 'building' | 'built' | 'verified' | 'ready' | 'archived';
 interface NextAction {
     command: string;
     description: string;
@@ -892,8 +896,10 @@ interface DeriveInput {
     cfg: AtlasConfig;
     approval: ApprovalStatus;
     blockingFindings: number;
+    mockupsReady?: boolean;
     specContent?: string;
 }
+declare function requiresMockups(meta: ChangeMeta | undefined, cfg: AtlasConfig): boolean;
 declare function deriveState(input: DeriveInput): DerivedState;
 declare function stateLabel(state: ChangeState): string;
 
@@ -1553,6 +1559,10 @@ interface CaptureResult {
     diagnostics: Diagnostic[];
 }
 declare function captureMockups(root: string, slug: string, manifest: MockupManifest, now?: Date): Promise<CaptureResult>;
+declare function mockupsReady(root: string, slug: string, change: Change): Promise<boolean>;
+declare function setMockupRequirement(root: string, slug: string, value: 'required' | 'skip'): Promise<{
+    path: string;
+}>;
 
 interface AdoptOptions {
     root: string;
@@ -1684,4 +1694,4 @@ declare function livingRequirementsMap(specs: Array<{
 }>): Map<string, Requirement>;
 declare function runCiGate(opts: CiOptions): Promise<CiResult>;
 
-export { type AdoptDomain, type AdoptOptions, type AdoptResult, type AgingBucket, type AnalyzeOptions, type AnalyzePackSummary, type AnalyzeResult, type Approval, type ApprovalStatus, type ApprovalsFile, type ApprovalsIndex, type ApproveFromGithubOptions, type ApproveFromGithubResult, type ArchiveOptions, type ArchiveResult, type AtlasConfig, type AttentionItem, BLOCK_HEAD_RE, BUILTIN_PACKS, type BlockWavePlan, CONFIG_FILE, CORE_VERSION, type CaptureResult, type Change, type ChangeMeta, type ChangeMetrics, type ChangeState, type CiCheck, type CiExtraCheck, type CiOptions, type CiResult, type Delta, type DeltaOp, type DeriveInput, type DerivedState, type DetectionResult, type Diagnostic, type DoctorReport, type Domain, type Evidence, type EvidenceMethod, type EvidenceResult, type ExecOptions, type ExecResult, type FoldOutcome, type FrontmatterResult, type GhRunner, type GitHubRepo, type InitOptions, type InitResult, type IssueBodyInput, type Lane, type Language, type LinkedIssue, type LintOptions, type LoadedConfig, type MockupCheckResult, type MockupManifest, type MockupPlan, type MockupPlanScreen, type MockupScreen, type NewChangeOptions, type NewChangeResult, type NextAction, type Override, type Pack, type PackCheck, type PackCheckResult, type PackCheckType, type PackEvaluation, type PresentOptions, type PresentResult, type ProfileMatch, REQ_HEAD_RE, REQ_ID_RE, RULE_ID_RE, RULE_RE, RUN_EVENT_TYPES, type RecordEvidenceOptions, type RecordEvidenceResult, type Rename, type Requirement, type RiskLevel, type Rule, type RunEvent, type RunEventType, type RunRecord, type RunState, type RunStatus, SCENARIO_HEAD_RE, SCENARIO_ID_RE, SDD_DIR, SLUG_RE, type Scenario, type Severity, type SignApprovalOptions, type SignApprovalResult, type SpecFile, type SpecRef, type StackProfile, type SyncGithubOptions, type SyncGithubResult, TASK_ID_RE, TASK_LINE_RE, type Task, type TaskBlock, type TasksFile, type TemplateSet, type TraceEdge, type TraceFinding, type TraceGraph, type TraceInput, type TraceNode, type TraceResult, type VerifyFile, type WalkEntry, type WavePlan, type Workspace, type WorkspaceMetrics, adoptWorkspace, appendRunEvent, approvalsSchema, approveFromGithub, archiveChange, artifactHash, atlasConfigSchema, buildTraceGraph, canonicalizeMarkdown, captureMockups, changeMarker, changeMetaSchema, changeMetaYaml, checkMockups, checkTrace, collectMetrics, commentIssue, compareTaskIds, computeInputsHash, configToYaml, copyFile, countBySeverity, createChange, createIssue, createRun, defaultConfig, deriveState, detectProfiles, detectRepo, detectionToYaml, diag, editIssue, emitFrontmatter, ensureDir, ensureSddDirs, esc, evaluatePacks, evidenceSummary, exists, findLinkedIssue, findWorkspaceRoot, firstToken, foldDelta, generatePresentation, generateRunId, getNumber, getString, ghAuthStatus, ghAvailable, hasErrors, hasShellMetacharacters, indexMarkdown, initWorkspace, inline, isCommandAllowed, isDirectory, issueBody, issueLabels, laneOrDefault, lintDelta, lintMockupHtml, lintMockupManifest, lintRequirement, lintSpec, lintTasks, lintVerify, listChangeSlugs, listDir, listDirs, listRuns, livingRequirementsMap, loadActiveProfile, loadApprovals, loadChange, loadConfig, loadDetectedBest, loadProfileFile, loadProfilesFromDir, loadProjectPacks, loadSpecs, loadWorkspace, matchGlob, mockupManifestSchema, mockupsDir, packFindings, parseApprovals, parseChangeMeta, parseConfig, parseDelta, parseFrontmatter, parseGitHubRemote, parseIssueUrl, parseRequirementBlocks, parseSpecFile, parseTasksFile, parseVerifyFile, patchChangeMeta, planBlock, planMockups, planWaves, profileSchema, readMockupManifest, readRun, readText, readTextIfExists, recordEvidence, regenerateIndex, renderMarkdown, renderRequirement, renderTemplate, resolvePacks, runAnalyze, runCiGate, runDoctor, runProcess, sha256, shortHash, signApproval, specHashOf, splitCommand, stateLabel, syncGithubIssue, templatesFor, toPosix, tokensFile, updateMockupScreenshots, updateRunStatus, verifyApproval, walkFiles, writeConfig, writeMockupManifest, writeMockupPlan, writeText };
+export { type AdoptDomain, type AdoptOptions, type AdoptResult, type AgingBucket, type AnalyzeOptions, type AnalyzePackSummary, type AnalyzeResult, type Approval, type ApprovalStatus, type ApprovalsFile, type ApprovalsIndex, type ApproveFromGithubOptions, type ApproveFromGithubResult, type ArchiveOptions, type ArchiveResult, type AtlasConfig, type AttentionItem, BLOCK_HEAD_RE, BUILTIN_PACKS, type BlockWavePlan, CONFIG_FILE, CORE_VERSION, type CaptureResult, type Change, type ChangeMeta, type ChangeMetrics, type ChangeState, type CiCheck, type CiExtraCheck, type CiOptions, type CiResult, type Delta, type DeltaOp, type DeriveInput, type DerivedState, type DetectionResult, type Diagnostic, type DoctorReport, type Domain, type Evidence, type EvidenceMethod, type EvidenceResult, type ExecOptions, type ExecResult, type FoldOutcome, type FrontmatterResult, type GhRunner, type GitHubRepo, type InitOptions, type InitResult, type IssueBodyInput, type Lane, type Language, type LinkedIssue, type LintOptions, type LoadedConfig, type MockupCheckResult, type MockupManifest, type MockupPlan, type MockupPlanScreen, type MockupScreen, type NewChangeOptions, type NewChangeResult, type NextAction, type Override, type Pack, type PackCheck, type PackCheckResult, type PackCheckType, type PackEvaluation, type PresentOptions, type PresentResult, type ProfileMatch, REQ_HEAD_RE, REQ_ID_RE, RULE_ID_RE, RULE_RE, RUN_EVENT_TYPES, type RecordEvidenceOptions, type RecordEvidenceResult, type Rename, type Requirement, type RiskLevel, type Rule, type RunEvent, type RunEventType, type RunRecord, type RunState, type RunStatus, SCENARIO_HEAD_RE, SCENARIO_ID_RE, SDD_DIR, SLUG_RE, type Scenario, type Severity, type SignApprovalOptions, type SignApprovalResult, type SpecFile, type SpecRef, type StackProfile, type SyncGithubOptions, type SyncGithubResult, TASK_ID_RE, TASK_LINE_RE, type Task, type TaskBlock, type TasksFile, type TemplateSet, type TraceEdge, type TraceFinding, type TraceGraph, type TraceInput, type TraceNode, type TraceResult, type VerifyFile, type WalkEntry, type WavePlan, type Workspace, type WorkspaceMetrics, adoptWorkspace, appendRunEvent, approvalsSchema, approveFromGithub, archiveChange, artifactHash, atlasConfigSchema, buildTraceGraph, canonicalizeMarkdown, captureMockups, changeMarker, changeMetaSchema, changeMetaYaml, checkMockups, checkTrace, collectMetrics, commentIssue, compareTaskIds, computeInputsHash, configToYaml, copyFile, countBySeverity, createChange, createIssue, createRun, defaultConfig, deriveState, detectProfiles, detectRepo, detectionToYaml, diag, editIssue, emitFrontmatter, ensureDir, ensureSddDirs, esc, evaluatePacks, evidenceSummary, exists, findLinkedIssue, findWorkspaceRoot, firstToken, foldDelta, generatePresentation, generateRunId, getNumber, getString, ghAuthStatus, ghAvailable, hasErrors, hasShellMetacharacters, indexMarkdown, initWorkspace, inline, isCommandAllowed, isDirectory, issueBody, issueLabels, laneOrDefault, lintDelta, lintMockupHtml, lintMockupManifest, lintRequirement, lintSpec, lintTasks, lintVerify, listChangeSlugs, listDir, listDirs, listRuns, livingRequirementsMap, loadActiveProfile, loadApprovals, loadChange, loadConfig, loadDetectedBest, loadProfileFile, loadProfilesFromDir, loadProjectPacks, loadSpecs, loadWorkspace, matchGlob, mockupManifestSchema, mockupsDir, mockupsReady, packFindings, parseApprovals, parseChangeMeta, parseConfig, parseDelta, parseFrontmatter, parseGitHubRemote, parseIssueUrl, parseRequirementBlocks, parseSpecFile, parseTasksFile, parseVerifyFile, patchChangeMeta, planBlock, planMockups, planWaves, profileSchema, readMockupManifest, readRun, readText, readTextIfExists, recordEvidence, regenerateIndex, renderMarkdown, renderRequirement, renderTemplate, requiresMockups, resolvePacks, runAnalyze, runCiGate, runDoctor, runProcess, setMockupRequirement, sha256, shortHash, signApproval, specHashOf, splitCommand, stateLabel, syncGithubIssue, templatesFor, toPosix, tokensFile, updateMockupScreenshots, updateRunStatus, verifyApproval, walkFiles, writeConfig, writeMockupManifest, writeMockupPlan, writeText };

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   sha256,
   shortHash,
   signApproval
-} from "./chunk-2BFXQ65Q.js";
+} from "./chunk-LMJURGRU.js";
 import {
   copyFile,
   ensureDir,
@@ -1008,6 +1008,14 @@ function verifyApproval(change, approvals, cfg, specContent) {
   if (current !== approval.hash) return { status: "stale", approvedBy: approval.by, approvedAt: approval.at };
   return { status: "valid", approvedBy: approval.by, approvedAt: approval.at };
 }
+function requiresMockups(meta, cfg) {
+  if (meta?.mockups === "required") return true;
+  if (meta?.mockups === "skip") return false;
+  return cfg.gates.mockup.require_approval;
+}
+function mockupOverride(change) {
+  return (change.meta?.overrides ?? []).some((override) => override.gate === "mockup");
+}
 function deriveState(input) {
   const { change, cfg, approval, blockingFindings } = input;
   const lane = change.meta?.lane ?? cfg.lanes.default;
@@ -1040,6 +1048,14 @@ function deriveState(input) {
     blockedBy.push(`${blockingFindings} hallazgo(s) bloqueante(s)`);
     return { state: "spec_draft", blockedBy, nextAction: next(`satlas validate --change ${change.slug}`, "Corregir los hallazgos de la especificaci\xF3n"), progress };
   }
+  if ((approval.status === "missing" || approval.status === "stale") && requiresMockups(change.meta, cfg) && input.mockupsReady !== true && !mockupOverride(change)) {
+    return {
+      state: "awaiting_mockups",
+      blockedBy: ["mockups requeridos y no listos"],
+      nextAction: next(`/satlas-mockup ${change.slug}`, "Generar los mockups (contrato visual) antes de aprobar", true),
+      progress
+    };
+  }
   if (approval.status === "missing" || approval.status === "stale") {
     blockedBy.push(approval.status === "stale" ? "la firma de la spec qued\xF3 obsoleta (el archivo cambi\xF3)" : "la spec no est\xE1 aprobada");
     const presented = change.presentationPath !== void 0;
@@ -1070,6 +1086,7 @@ function stateLabel(state) {
   const labels = {
     draft: "borrador",
     spec_draft: "spec en borrador",
+    awaiting_mockups: "esperando mockups",
     awaiting_approval: "esperando aprobaci\xF3n",
     approved: "aprobado",
     planned: "planificado",
@@ -1653,6 +1670,7 @@ function changeMetaYaml(meta) {
   if (meta.risk) doc["risk"] = meta.risk;
   if (meta.created) doc["created"] = meta.created;
   if (meta.owner) doc["owner"] = meta.owner;
+  if (meta.mockups) doc["mockups"] = meta.mockups;
   return `# Estado del cambio. La fase se DERIVA de los artefactos; aqu\xED solo hechos.
 ` + stringifyYaml3(doc, { lineWidth: 120 });
 }
@@ -1951,7 +1969,7 @@ async function approveFromGithub(opts) {
   if (!by) {
     return { approved: false, label, issueNumber: number, diagnostics: [diag("ATLAS-GH-011", "error", "No se pudo determinar qui\xE9n aprueba (--by ni `gh api user`)")] };
   }
-  const { signApproval: signApproval2 } = await import("./approvals-HCBC7QDM.js");
+  const { signApproval: signApproval2 } = await import("./approvals-4QHIT7F6.js");
   const signed = await signApproval2({
     root: opts.root,
     artifact: path5.posix.join("changes", opts.slug, "spec.md"),
@@ -2514,6 +2532,28 @@ async function captureMockups(root, slug, manifest, now = /* @__PURE__ */ new Da
   void now;
   return { screenshots, diagnostics };
 }
+async function mockupsReady(root, slug, change) {
+  const check = await checkMockups(root, slug, change);
+  return Boolean(check.manifest && check.manifest.screens.length > 0 && !check.stale);
+}
+async function setMockupRequirement(root, slug, value) {
+  const file = path8.join(root, ".sdd", "changes", slug, "meta.yaml");
+  const raw = await readTextIfExists(file) ?? `schema_version: 1
+slug: ${slug}
+lane: standard
+`;
+  const lines = raw.replace(/\r\n?/g, "\n").split("\n");
+  const index = lines.findIndex((line) => /^mockups:/.test(line));
+  if (index >= 0) {
+    lines[index] = `mockups: ${value}`;
+  } else {
+    let last = lines.length;
+    while (last > 0 && (lines[last - 1] ?? "").trim() === "") last -= 1;
+    lines.splice(last, 0, `mockups: ${value}`);
+  }
+  await writeText(file, lines.join("\n"));
+  return { path: file };
+}
 
 // src/packs.ts
 import path9 from "path";
@@ -3080,6 +3120,8 @@ async function generatePresentation(opts) {
   const mockupInfo = await copyMockups(root, change, mockupsCopyDir);
   const proposalRaw = await readTextIfExists(path12.join(change.dir, "proposal.md"));
   const proposalBody = proposalRaw ? parseFrontmatter(proposalRaw).body : "";
+  const approvals = await loadApprovals(path12.join(root, ".sdd"));
+  const approval = verifyApproval(change, approvals.byArtifact, config, deltaContent);
   const labels = labelsFor(language);
   const html = page({
     language,
@@ -3096,7 +3138,8 @@ async function generatePresentation(opts) {
     evidence: new Map((change.verify?.evidence ?? []).map((e) => [e.scenario, e.result])),
     mockups: mockupInfo.screens,
     screenshots: mockupInfo.screenshots,
-    approveHint: `satlas approve ${change.slug} --by "<nombre>" --channel presentation`
+    approveHint: `satlas approve ${change.slug} --by "<nombre>" --channel presentation`,
+    ...approval.status === "valid" && approval.approvedBy ? { approval: { by: approval.approvedBy, at: approval.approvedAt ?? "" } } : {}
   });
   const outFile = path12.join(presentationDir, "index.html");
   await writeText(outFile, html);
@@ -3147,6 +3190,7 @@ function labelsFor(language) {
       mockups: "Mockups",
       approve: "Approval",
       approveText: "This proposal is approved by signing the spec (hash + author). Any later change invalidates the signature.",
+      approveDone: "Approved by {by} on {at}. Any later change invalidates the signature.",
       command: "Command",
       hash: "Hash",
       generated: "Generated",
@@ -3168,6 +3212,7 @@ function labelsFor(language) {
     mockups: "Mockups",
     approve: "Aprobaci\xF3n",
     approveText: "Esta propuesta se aprueba firmando la spec (hash + autor). Cualquier cambio posterior invalida la firma.",
+    approveDone: "Aprobada por {by} el {at}. Cualquier cambio posterior invalida la firma.",
     command: "Comando",
     hash: "Hash",
     generated: "Generado",
@@ -3283,8 +3328,8 @@ function page(input) {
 
   <section>
     <h2>${esc(l.approve)}</h2>
-    <div class="callout">${esc(l.approveText)}</div>
-    <p>${esc(l.command)}: <code>${esc(input.approveHint)}</code></p>
+    ${input.approval ? `<div class="callout" style="border-left-color:#15803d;background:rgba(21,128,61,.12)">\u2714 ${esc(l.approveDone.replace("{by}", input.approval.by).replace("{at}", input.approval.at))}</div>` : `<div class="callout">${esc(l.approveText)}</div>
+    <p>${esc(l.command)}: <code>${esc(input.approveHint)}</code></p>`}
   </section>
 
   <footer>SpecAtlas \xB7 ${esc(input.project)} \xB7 ${esc(input.generatedAt)}</footer>
@@ -4037,6 +4082,7 @@ export {
   matchGlob,
   mockupManifestSchema,
   mockupsDir,
+  mockupsReady,
   packFindings,
   parseApprovals,
   parseChangeMeta,
@@ -4065,11 +4111,13 @@ export {
   renderRequirement,
   renderStyles,
   renderTemplate,
+  requiresMockups,
   resolvePacks,
   runAnalyze,
   runCiGate,
   runDoctor,
   runProcess,
+  setMockupRequirement,
   sha256,
   shortHash,
   signApproval,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specatlas/core",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Kernel determinista de SpecAtlas: parsing, validación, trazabilidad, olas y ciclo de vida",
   "license": "MIT",
   "type": "module",