@semacode/cli 2.2.0 → 2.3.1

package/exemplos/sistemas-interativos/game-pixel-16-bit.json

@@ -0,0 +1,97 @@
+{
+  "schemaVersion": "1.0",
+  "systemId": "example.game.pixel-16-bit",
+  "version": "1.0.0",
+  "kind": "GAME",
+  "spatialModel": "TWO_D",
+  "renderMode": "VISUAL",
+  "visualProfile": "PIXEL_16_BIT",
+  "fidelity": "STYLIZED",
+  "controlModes": [
+    "HUMAN"
+  ],
+  "timeModel": "FIXED_STEP",
+  "determinism": "SEEDED",
+  "capabilities": [
+    "game.progression.curve",
+    "game.progression.exploit",
+    "game.progression.model",
+    "interactive.control.human",
+    "interactive.determinism.seeded",
+    "interactive.event.log",
+    "interactive.fidelity.stylized",
+    "interactive.kind.game",
+    "interactive.render.visual",
+    "interactive.replay.compare",
+    "interactive.runtime.bind",
+    "interactive.seed.bind",
+    "interactive.smoke.observe",
+    "interactive.snapshot.capture",
+    "interactive.spatial.two_d",
+    "interactive.state.model",
+    "interactive.time.fixed_step",
+    "interactive.visual.pixel_16_bit",
+    "interactive.world.model"
+  ],
+  "pipelines": [
+    "interactive.prototype",
+    "game.progression",
+    "interactive.replay"
+  ],
+  "adapterTargets": [
+    "engine.tic80",
+    "telemetry.trace.local",
+    "validator.replay.local"
+  ],
+  "world": {
+    "identity": "side-view action adventure",
+    "state": {
+      "area": "harbour",
+      "abilities": [
+        "dash"
+      ]
+    },
+    "time": {
+      "tickRateHz": 60
+    },
+    "events": [
+      "enemy.defeat",
+      "ability.unlock",
+      "checkpoint.activate"
+    ],
+    "initialConditions": {
+      "area": "harbour",
+      "health": 5
+    },
+    "coordinateSystem": "screen-space origin top-left",
+    "grid": "16 px metatiles on a 320x180 canvas",
+    "loop": "explore, fight, unlock, return",
+    "objective": "restore the harbour beacon",
+    "successConditions": [
+      "beacon restored"
+    ],
+    "failureConditions": [
+      "health reaches zero before a checkpoint"
+    ],
+    "rules": [
+      "abilities unlock through declared progression gates",
+      "animation frames use the declared sprite budget"
+    ],
+    "seed": 16,
+    "snapshot": "checkpoint state",
+    "replay": "input transitions and progression events",
+    "step": "one 60 Hz tick"
+  },
+  "budgets": {
+    "paletteColors": 256,
+    "baseResolution": "320x180",
+    "tileSize": "16x16",
+    "spriteSize": "16x32 and 32x32",
+    "memoryBudgetBytes": 262144,
+    "audioProfile": "sampled tracker with eight voices"
+  },
+  "acceptance": {
+    "progression": "every required ability is reachable without sequence breaking",
+    "pixelIntegrity": "camera scaling preserves hard pixel edges"
+  }
+}

package/exemplos/sistemas-interativos/game-pixel-8-bit.json

@@ -0,0 +1,94 @@
+{
+  "schemaVersion": "1.0",
+  "systemId": "example.game.pixel-8-bit",
+  "version": "1.0.0",
+  "kind": "GAME",
+  "spatialModel": "TWO_D",
+  "renderMode": "VISUAL",
+  "visualProfile": "PIXEL_8_BIT",
+  "fidelity": "ARCADE",
+  "controlModes": [
+    "HUMAN"
+  ],
+  "timeModel": "FIXED_STEP",
+  "determinism": "SEEDED",
+  "capabilities": [
+    "interactive.control.human",
+    "interactive.determinism.seeded",
+    "interactive.event.log",
+    "interactive.failure.observe",
+    "interactive.fidelity.arcade",
+    "interactive.kind.game",
+    "interactive.playtest.plan",
+    "interactive.render.visual",
+    "interactive.replay.compare",
+    "interactive.runtime.bind",
+    "interactive.runtime.observe",
+    "interactive.seed.bind",
+    "interactive.smoke.observe",
+    "interactive.snapshot.capture",
+    "interactive.spatial.two_d",
+    "interactive.state.model",
+    "interactive.time.fixed_step",
+    "interactive.visual.pixel_8_bit",
+    "interactive.world.model"
+  ],
+  "pipelines": [
+    "interactive.prototype",
+    "interactive.playtest",
+    "interactive.replay"
+  ],
+  "adapterTargets": [
+    "engine.pico8",
+    "telemetry.trace.local",
+    "validator.replay.local"
+  ],
+  "world": {
+    "identity": "compact single-screen platform game",
+    "state": {
+      "room": 1,
+      "score": 0
+    },
+    "time": {
+      "tickRateHz": 30
+    },
+    "events": [
+      "player.jump",
+      "coin.collect",
+      "player.hit"
+    ],
+    "initialConditions": {
+      "room": 1,
+      "lives": 3
+    },
+    "grid": "8 px tiles on a 128x128 canvas",
+    "loop": "move, jump, collect, exit",
+    "objective": "collect every coin and reach the exit",
+    "successConditions": [
+      "exit reached after all coins are collected"
+    ],
+    "failureConditions": [
+      "all lives exhausted"
+    ],
+    "rules": [
+      "integer-aligned sprite positions",
+      "no sub-pixel rendering"
+    ],
+    "seed": 8,
+    "snapshot": "room state at entry",
+    "replay": "button transitions per fixed tick",
+    "step": "one 30 Hz tick"
+  },
+  "budgets": {
+    "paletteColors": 16,
+    "baseResolution": "128x128",
+    "tileSize": "8x8",
+    "spriteSize": "8x8 and 16x16",
+    "memoryBudgetBytes": 32768,
+    "audioProfile": "four-channel chiptune"
+  },
+  "acceptance": {
+    "pixelIntegrity": "sprites and tiles stay on the integer grid",
+    "playability": "the full loop is completable with two buttons and a d-pad"
+  }
+}

package/exemplos/sistemas-interativos/game-xr-human.json

@@ -0,0 +1,80 @@
+{
+  "schemaVersion": "1.0",
+  "systemId": "example.game.xr.human",
+  "version": "1.0.0",
+  "kind": "GAME",
+  "spatialModel": "THREE_D",
+  "renderMode": "XR",
+  "visualProfile": "REALISTIC",
+  "fidelity": "STYLIZED",
+  "controlModes": [
+    "HUMAN"
+  ],
+  "timeModel": "REAL_TIME",
+  "determinism": "BEST_EFFORT",
+  "capabilities": [
+    "interactive.control.human",
+    "interactive.determinism.best_effort",
+    "interactive.failure.observe",
+    "interactive.fidelity.stylized",
+    "interactive.kind.game",
+    "interactive.playtest.plan",
+    "interactive.render.xr",
+    "interactive.replay.compare",
+    "interactive.runtime.bind",
+    "interactive.runtime.observe",
+    "interactive.smoke.observe",
+    "interactive.spatial.three_d",
+    "interactive.state.model",
+    "interactive.time.real_time",
+    "interactive.visual.realistic",
+    "interactive.world.model"
+  ],
+  "pipelines": [
+    "interactive.prototype",
+    "interactive.playtest"
+  ],
+  "adapterTargets": [
+    "engine.godot",
+    "telemetry.trace.local",
+    "validator.replay.local"
+  ],
+  "world": {
+    "identity": "room-scale cooperative repair game",
+    "state": {
+      "station": "offline",
+      "completedRepairs": 0
+    },
+    "time": {
+      "tickRateHz": 90
+    },
+    "events": [
+      "tool.grab",
+      "component.install",
+      "station.restart"
+    ],
+    "initialConditions": {
+      "playerPose": "calibrated-origin",
+      "station": "offline"
+    },
+    "units": "metres",
+    "scale": "1 unit = 1 metre",
+    "coordinateSystem": "right-handed Y-up room space",
+    "loop": "inspect, grab, repair, test",
+    "objective": "restart the station",
+    "successConditions": [
+      "station reports operational"
+    ],
+    "failureConditions": [
+      "session safety boundary is breached"
+    ],
+    "rules": [
+      "interactions require reachable controller poses",
+      "locomotion respects the declared comfort mode"
+    ]
+  },
+  "acceptance": {
+    "comfort": "turning and locomotion respect the configured comfort policy",
+    "interaction": "all required repair actions are reachable from a calibrated room origin"
+  }
+}

package/exemplos/sistemas-interativos/hybrid-2-5d.json

@@ -0,0 +1,108 @@
+{
+  "schemaVersion": "1.0",
+  "systemId": "example.hybrid.2-5d.seeded",
+  "version": "1.0.0",
+  "kind": "HYBRID",
+  "spatialModel": "TWO_POINT_FIVE_D",
+  "renderMode": "VISUAL",
+  "visualProfile": "STYLIZED",
+  "fidelity": "SYSTEMIC",
+  "controlModes": [
+    "HYBRID"
+  ],
+  "timeModel": "FIXED_STEP",
+  "determinism": "SEEDED",
+  "capabilities": [
+    "interactive.control.hybrid",
+    "interactive.determinism.seeded",
+    "interactive.event.log",
+    "interactive.failure.observe",
+    "interactive.fidelity.systemic",
+    "interactive.kind.hybrid",
+    "interactive.playtest.plan",
+    "interactive.render.visual",
+    "interactive.replay.compare",
+    "interactive.runtime.bind",
+    "interactive.runtime.observe",
+    "interactive.seed.bind",
+    "interactive.smoke.observe",
+    "interactive.snapshot.capture",
+    "interactive.spatial.2_5_d",
+    "interactive.state.model",
+    "interactive.time.fixed_step",
+    "interactive.visual.stylized",
+    "interactive.world.model",
+    "simulation.model",
+    "simulation.outputs.observe",
+    "simulation.scenario.define"
+  ],
+  "pipelines": [
+    "interactive.prototype",
+    "interactive.playtest",
+    "simulation.scenario",
+    "interactive.replay"
+  ],
+  "adapterTargets": [
+    "engine.godot",
+    "telemetry.trace.local",
+    "validator.replay.local"
+  ],
+  "world": {
+    "identity": "2.5D emergency-routing training sandbox",
+    "state": {
+      "district": "coastal-a",
+      "evacuatedAgents": 0
+    },
+    "time": {
+      "fixedStepSeconds": 0.25
+    },
+    "events": [
+      "route.open",
+      "hazard.spread",
+      "agent.evacuate"
+    ],
+    "initialConditions": {
+      "hazardOrigin": "sector-4",
+      "activeRoutes": 3
+    },
+    "coordinateSystem": "isometric grid with metric depth",
+    "grid": "1 metre navigation cells",
+    "loop": "inspect, route, advance, review",
+    "objective": "evacuate the declared population before the horizon",
+    "successConditions": [
+      "all reachable agents evacuated"
+    ],
+    "failureConditions": [
+      "simulation horizon reached with reachable agents remaining"
+    ],
+    "rules": [
+      "human route choices and scripted agents share one state model",
+      "render depth does not change navigation costs"
+    ],
+    "model": "discrete agent movement over a weighted evacuation graph",
+    "assumptions": [
+      "agents select only currently open routes"
+    ],
+    "boundaryConditions": {
+      "horizonSeconds": 900,
+      "maximumAgents": 500
+    },
+    "outputs": [
+      "evacuationTimeSeconds",
+      "routeUtilisation",
+      "agentsRemaining"
+    ],
+    "validation": {
+      "method": "compare replay outputs against declared evacuation invariants",
+      "invariants": ["agent counts are conserved", "route costs remain non-negative"]
+    },
+    "seed": 2026071904,
+    "snapshot": "graph, agents, hazard, and human decisions",
+    "replay": "ordered route decisions and simulation events",
+    "step": "fixed 0.25 second update"
+  },
+  "acceptance": {
+    "hybridBoundary": "human actions and simulated agents remain distinguishable in the event log",
+    "projection": "2.5D rendering preserves the underlying metric grid"
+  }
+}

package/exemplos/sistemas-interativos/protocol-mutating-rollback-valid.json

@@ -0,0 +1,75 @@
+{
+  "runId": "fixture.protocol.mutating-rollback.001",
+  "adapterId": "engine.godot",
+  "adapterVersion": "1.0.0",
+  "semanticTargetId": "example.game.3d.human",
+  "phases": [
+    {
+      "phaseId": "mutating.detect",
+      "phase": "DETECT",
+      "semanticTargetId": "example.game.3d.human",
+      "inputDigest": "sha256:8faad66a2e59a27af6bbc6e1421493a2f3758f376515c44e2e16fbcb340ac082",
+      "outputDigest": "sha256:4f135cff766c846e90720c6e50676c37a7b98023bbe7b1ef6b3fa46fd54ffc2d",
+      "success": true
+    },
+    {
+      "phaseId": "mutating.probe",
+      "phase": "PROBE",
+      "semanticTargetId": "example.game.3d.human",
+      "inputDigest": "sha256:8faad66a2e59a27af6bbc6e1421493a2f3758f376515c44e2e16fbcb340ac082",
+      "outputDigest": "sha256:4f135cff766c846e90720c6e50676c37a7b98023bbe7b1ef6b3fa46fd54ffc2d",
+      "success": true
+    },
+    {
+      "phaseId": "mutating.snapshot",
+      "phase": "SNAPSHOT",
+      "semanticTargetId": "example.game.3d.human",
+      "inputDigest": "sha256:8faad66a2e59a27af6bbc6e1421493a2f3758f376515c44e2e16fbcb340ac082",
+      "outputDigest": "sha256:4f135cff766c846e90720c6e50676c37a7b98023bbe7b1ef6b3fa46fd54ffc2d",
+      "success": true
+    },
+    {
+      "phaseId": "mutating.plan",
+      "phase": "PLAN",
+      "semanticTargetId": "example.game.3d.human",
+      "inputDigest": "sha256:8faad66a2e59a27af6bbc6e1421493a2f3758f376515c44e2e16fbcb340ac082",
+      "outputDigest": "sha256:4f135cff766c846e90720c6e50676c37a7b98023bbe7b1ef6b3fa46fd54ffc2d",
+      "success": true
+    },
+    {
+      "phaseId": "mutating.apply",
+      "phase": "APPLY",
+      "semanticTargetId": "example.game.3d.human",
+      "inputDigest": "sha256:8faad66a2e59a27af6bbc6e1421493a2f3758f376515c44e2e16fbcb340ac082",
+      "outputDigest": "sha256:4f135cff766c846e90720c6e50676c37a7b98023bbe7b1ef6b3fa46fd54ffc2d",
+      "success": true
+    },
+    {
+      "phaseId": "mutating.validate",
+      "phase": "VALIDATE",
+      "semanticTargetId": "example.game.3d.human",
+      "inputDigest": "sha256:8faad66a2e59a27af6bbc6e1421493a2f3758f376515c44e2e16fbcb340ac082",
+      "outputDigest": "sha256:4f135cff766c846e90720c6e50676c37a7b98023bbe7b1ef6b3fa46fd54ffc2d",
+      "success": false
+    },
+    {
+      "phaseId": "mutating.evidence",
+      "phase": "EVIDENCE",
+      "semanticTargetId": "example.game.3d.human",
+      "inputDigest": "sha256:8faad66a2e59a27af6bbc6e1421493a2f3758f376515c44e2e16fbcb340ac082",
+      "outputDigest": "sha256:4f135cff766c846e90720c6e50676c37a7b98023bbe7b1ef6b3fa46fd54ffc2d",
+      "success": true
+    },
+    {
+      "phaseId": "mutating.rollback",
+      "phase": "ROLLBACK",
+      "semanticTargetId": "example.game.3d.human",
+      "inputDigest": "sha256:8faad66a2e59a27af6bbc6e1421493a2f3758f376515c44e2e16fbcb340ac082",
+      "outputDigest": "sha256:4f135cff766c846e90720c6e50676c37a7b98023bbe7b1ef6b3fa46fd54ffc2d",
+      "success": true
+    }
+  ],
+  "mutated": true,
+  "success": false,
+  "rollbackEvidenceId": "fixture.rollback.observed.001"
+}

package/exemplos/sistemas-interativos/protocol-read-only-valid.json

@@ -0,0 +1,58 @@
+{
+  "runId": "fixture.protocol.read-only.001",
+  "adapterId": "runtime.headless.generic",
+  "adapterVersion": "1.0.0",
+  "semanticTargetId": "example.simulation.headless.autonomous-batch",
+  "phases": [
+    {
+      "phaseId": "readonly.detect",
+      "phase": "DETECT",
+      "semanticTargetId": "example.simulation.headless.autonomous-batch",
+      "inputDigest": "sha256:8faad66a2e59a27af6bbc6e1421493a2f3758f376515c44e2e16fbcb340ac082",
+      "outputDigest": "sha256:4f135cff766c846e90720c6e50676c37a7b98023bbe7b1ef6b3fa46fd54ffc2d",
+      "success": true
+    },
+    {
+      "phaseId": "readonly.probe",
+      "phase": "PROBE",
+      "semanticTargetId": "example.simulation.headless.autonomous-batch",
+      "inputDigest": "sha256:8faad66a2e59a27af6bbc6e1421493a2f3758f376515c44e2e16fbcb340ac082",
+      "outputDigest": "sha256:4f135cff766c846e90720c6e50676c37a7b98023bbe7b1ef6b3fa46fd54ffc2d",
+      "success": true
+    },
+    {
+      "phaseId": "readonly.snapshot",
+      "phase": "SNAPSHOT",
+      "semanticTargetId": "example.simulation.headless.autonomous-batch",
+      "inputDigest": "sha256:8faad66a2e59a27af6bbc6e1421493a2f3758f376515c44e2e16fbcb340ac082",
+      "outputDigest": "sha256:4f135cff766c846e90720c6e50676c37a7b98023bbe7b1ef6b3fa46fd54ffc2d",
+      "success": true
+    },
+    {
+      "phaseId": "readonly.plan",
+      "phase": "PLAN",
+      "semanticTargetId": "example.simulation.headless.autonomous-batch",
+      "inputDigest": "sha256:8faad66a2e59a27af6bbc6e1421493a2f3758f376515c44e2e16fbcb340ac082",
+      "outputDigest": "sha256:4f135cff766c846e90720c6e50676c37a7b98023bbe7b1ef6b3fa46fd54ffc2d",
+      "success": true
+    },
+    {
+      "phaseId": "readonly.validate",
+      "phase": "VALIDATE",
+      "semanticTargetId": "example.simulation.headless.autonomous-batch",
+      "inputDigest": "sha256:8faad66a2e59a27af6bbc6e1421493a2f3758f376515c44e2e16fbcb340ac082",
+      "outputDigest": "sha256:4f135cff766c846e90720c6e50676c37a7b98023bbe7b1ef6b3fa46fd54ffc2d",
+      "success": true
+    },
+    {
+      "phaseId": "readonly.evidence",
+      "phase": "EVIDENCE",
+      "semanticTargetId": "example.simulation.headless.autonomous-batch",
+      "inputDigest": "sha256:8faad66a2e59a27af6bbc6e1421493a2f3758f376515c44e2e16fbcb340ac082",
+      "outputDigest": "sha256:4f135cff766c846e90720c6e50676c37a7b98023bbe7b1ef6b3fa46fd54ffc2d",
+      "success": true
+    }
+  ],
+  "mutated": false,
+  "success": true
+}

package/exemplos/sistemas-interativos/simulation-2d-controlled.json

@@ -0,0 +1,97 @@
+{
+  "schemaVersion": "1.0",
+  "systemId": "example.simulation.2d.controlled",
+  "version": "1.0.0",
+  "kind": "SIMULATION",
+  "spatialModel": "TWO_D",
+  "renderMode": "VISUAL",
+  "visualProfile": "VECTOR",
+  "fidelity": "SYSTEMIC",
+  "controlModes": [
+    "SCRIPTED"
+  ],
+  "timeModel": "FIXED_STEP",
+  "determinism": "SEEDED",
+  "capabilities": [
+    "interactive.control.scripted",
+    "interactive.determinism.seeded",
+    "interactive.event.log",
+    "interactive.fidelity.systemic",
+    "interactive.kind.simulation",
+    "interactive.render.visual",
+    "interactive.replay.compare",
+    "interactive.seed.bind",
+    "interactive.snapshot.capture",
+    "interactive.spatial.two_d",
+    "interactive.state.model",
+    "interactive.time.fixed_step",
+    "interactive.visual.vector",
+    "interactive.world.model",
+    "simulation.invariants.validate",
+    "simulation.model",
+    "simulation.outputs.compare",
+    "simulation.outputs.observe",
+    "simulation.scenario.define",
+    "simulation.validity.report"
+  ],
+  "pipelines": [
+    "simulation.scenario",
+    "simulation.validate",
+    "interactive.replay"
+  ],
+  "adapterTargets": [
+    "engine.web.canvas2d",
+    "simulation.runner.generic",
+    "telemetry.trace.local",
+    "validator.replay.local"
+  ],
+  "world": {
+    "identity": "script-controlled urban traffic grid",
+    "state": {
+      "vehicles": 120,
+      "signals": "timed-plan-a"
+    },
+    "time": {
+      "fixedStepSeconds": 0.1
+    },
+    "events": [
+      "vehicle.enter",
+      "signal.change",
+      "vehicle.exit"
+    ],
+    "initialConditions": {
+      "demandProfile": "weekday-am",
+      "signalPlan": "timed-plan-a"
+    },
+    "grid": "lane graph projected onto a 2D metric plane",
+    "coordinateSystem": "local east-north metres",
+    "model": "cell-transmission traffic flow with scripted signal phases",
+    "assumptions": [
+      "driver response is homogeneous inside each vehicle class"
+    ],
+    "boundaryConditions": {
+      "inflowVehiclesPerHour": 900,
+      "simulationDurationSeconds": 3600
+    },
+    "outputs": [
+      "meanTravelTimeSeconds",
+      "queueLengthVehicles",
+      "throughputVehiclesPerHour"
+    ],
+    "validation": {
+      "method": "compare seeded replay outputs with conservation invariants",
+      "invariants": ["vehicle count is conserved", "queue length remains non-negative"]
+    },
+    "seed": 2026071902,
+    "snapshot": "network, queues, signals, and random stream state",
+    "replay": "scripted demand and signal events",
+    "step": "fixed 0.1 second update"
+  },
+  "acceptance": {
+    "invariants": [
+      "vehicle count is conserved",
+      "queue length is never negative"
+    ],
+    "outputs": "all declared metrics are emitted for every completed run"
+  }
+}