@maka/maka-cli 5.127.0 → 5.129.0

package/bundle/typescript/src/commands/game/sideQuest/types/repro.d.ts

@@ -1,379 +0,0 @@
-import { Direction } from './shared/direction-enum.js';
-import { DeviceSeedKind } from './seed/device-seed.js';
-/**
- * A REPRO FIXTURE -- the bench a review item ships with itself.
- *
- * The problem this exists for, in the reporter's words: "Many backlog
- * items are found during a run, so reproducing them for testing is
- * difficult... I'm trying to review the item fixed by commit 359ad1fe.
- * But I can't get to a barrier like a lock or ward."
- *
- * That is exactly true, and not a discoverability problem -- the static
- * scenes carry no devices at all, so there is nowhere in the shipped
- * game to go and stand in front of a maglock. Every fix that touches a
- * barrier has been unconfirmable for the same reason.
- *
- * WHY A SPEC AND NOT A SCENE. The obvious answer is to grow one scene a
- * fixture per item, and the reporter rejected it: the fixtures pile up
- * forever, in a scene that doubles as the generation-failure fallback
- * for ordinary players, inside the shipped binary and in git for good.
- * So each item carries a ~20-line spec instead, and the client builds a
- * two-room bench from it on demand. Nothing accumulates anywhere.
- *
- * WHY INTENT AND NOT STRUCTURE. Everything here says what the bench is
- * FOR, never how to wire it. `atDoorway: true` is a statement about the
- * fiction; deriving the spot name it implies is the builder's job, and
- * that division is the whole design (see factories/repro-scene.ts).
- * Hand-authored seed JSON can be subtly wrong in the way this codebase
- * keeps shipping -- a check whose two sides fail together cannot see
- * the failure -- and a repro that quietly proves the opposite of what
- * it claims is worse than no repro at all.
- */
-/** Which side of the sealed door something stands on. The BARRIER side
- *  is the room the device is in and the room that declares the exit it
- *  seals; the FAR side is through the door. */
-export type ReproSide = 'barrier' | 'far';
-export interface IReproBarrier {
-    kind: DeviceSeedKind;
-    /** Defaults per kind -- Maglock, Keypad, Chalk Ward. */
-    name?: string;
-    /** The credential it answers to. PANEL ONLY, and the builder refuses
-     *  it elsewhere rather than dropping it: "if it's a _mechanical_ lock,
-     *  it has a key or can be picked. You can't talk at a _mechanical_
-     *  lock." A code that silently does nothing is a repro that proves
-     *  nothing. */
-    code?: string;
-    /** An item that opens it outright. Placed on the runner's own side. */
-    keyItem?: string;
-    /** Start it ALREADY OPEN. Not a curiosity -- an NPC's brief has to be
-     *  right about an opened barrier too, and getting that wrong is a
-     *  live item on the board. */
-    open?: boolean;
-    /** The lock's Device Rating (p.359-360): the Locksmith Extended Test
-     *  threshold is Rating x 2, and a Sequencer or Passkey rolls against
-     *  it. Defaults to the kind's (a door lock is 2, p.356). */
-    rating?: number;
-    /** What it is made of (p.197): Structure and Armor for shooting it
-     *  apart. Defaults to Reinforced (8 / 12). */
-    structure?: number;
-    armor?: number;
-    /** The exit it seals. Defaults to north. */
-    sealsExit?: Direction;
-}
-export interface IReproNpc {
-    name: string;
-    /** What they are, in a sentence. Becomes the description AND the AI
-     *  brief, so an NPC in a repro is briefed the way a real one is --
-     *  which matters, because half these items are about what an NPC
-     *  believes about a door. */
-    concept: string;
-    side?: ReproSide;
-    /** Standing IN the sealed doorway. */
-    atDoorway?: boolean;
-    /** Holding it shut: a doorman, a picket. Implies atDoorway, because a
-     *  guard who is not in the doorway guards nothing. */
-    guarding?: boolean;
-    /**
-     * ARMED AND WIRELESS -- a firearm and a commlink.
-     *
-     * Added because a bench could not express "somebody over there is
-     * carrying a gun", which is the whole subject of the p.219 icon item:
-     * an interesting or dangerous device should break out as its own icon
-     * beside its owner's PAN. The bench's NPC answered "runs no devices at
-     * all, nothing to crack", so the fixture could not reach the thing it
-     * was built to show.
-     *
-     * IT ALSO UNLOCKS `hack <name>` ON A BENCH, which is worth saying
-     * because it is not what the flag is named for and someone looking
-     * for it will not think to read "armed". The commlink is what gives
-     * the NPC a PAN at all, so every PAN-side Matrix action -- the
-     * intrusion, its brackets, jamming a smartgun, cutting an overlay --
-     * became reachable from a repro the day this landed.
-     *
-     * It was the ONLY Matrix action a bench could reach until `host`
-     * arrived; `ice` below now covers the host's own defender. Kept
-     * current deliberately -- the .com bench generator is taught from
-     * these comments, so a stale "the builder cannot make that" teaches
-     * a capability away.
-     */
-    armed?: boolean;
-    /**
-     * NO SPOT AT ALL -- this one circulates instead of standing
-     * somewhere (measured by backlog-session-2 for S6b4TLQWq46RN5kGu,
-     * map placement).
-     *
-     * Every bench NPC otherwise gets a spot, so nothing on a bench
-     * could circulate and the placement reports had nothing to
-     * reproduce against.
-     *
-     * REFUSED alongside `guarding` or `atDoorway`, rather than
-     * silently resolved: this file already holds that a guard who is
-     * not in the doorway guards nothing, and a circulating guard is
-     * that same defect wearing a new flag -- it would pass the
-     * walkthrough while holding nothing.
-     */
-    circulating?: boolean;
-    /**
-     * INTRUSION COUNTERMEASURES -- this one is ICE, not a person.
-     *
-     * Added because the Matrix benches could reach a PAN and nothing
-     * else: `armed` gives an NPC a commlink, so PAN intrusion became
-     * benchable, but a HOST's own defender did not exist. Every report
-     * about ice -- what it does on arrival, whether it is opposition,
-     * what `hack` meets inside a node -- had to be shown against a
-     * shipped scene or not at all.
-     *
-     * PLUMBING, NOT A NEW RULE, on the same standard as IReproHost:
-     * npc-seed.ts already states that plane 'matrix' MAKES an NPC ice, so
-     * this flag maps to a meaning the seed layer already carries. It
-     * rides IReproHost rather than extending it -- the host does not need
-     * to know ice exists.
-     *
-     * IT STANDS INSIDE THE HOST, not beside it. scene-factory puts every
-     * matrix-plane NPC in a hasNode room inside that node, so a bench's
-     * ice is unreachable from the outside grid and invisible from it,
-     * both directions (p.246) -- `enter` the host and it is there. That
-     * matters when writing steps: a spike or a decompile aimed at bench
-     * ice from the street now finds no target, which is the rule and not
-     * a broken fixture.
-     *
-     * IT IS OPPOSITION WITHOUT SAYING SO, which is the property the
-     * hostility bench needs: scene-factory treats a matrix-plane NPC as
-     * hostile by construction unless a seed explicitly says otherwise
-     * (JjQdy4A4tzcQdPHno). A fixture that had to declare `hostile: true`
-     * to get hostile ice would be proving the flag, not the rule.
-     *
-     * REFUSED WITHOUT A HOST. Ice with nothing to guard is not a thing,
-     * and a builder that quietly promoted it to a host would invent the
-     * very fixture the bench was meant to demonstrate.
-     *
-     * REFUSED WITH atDoorway, guarding, circulating OR armed (raised by
-     * backlog-session-1, and right). Spots are MEAT positions -- spotOf
-     * returns undefined off the meat plane -- so a spot on ice is
-     * silently inert rather than wrong, which is exactly what these
-     * invariants exist to catch. And the armed kit is a pistol and a
-     * commlink, which on a countermeasure is either meaningless or a lie.
-     */
-    ice?: boolean;
-}
-export interface IReproItem {
-    name: string;
-    description: string;
-    /**
-     * Put it AT THE DOORWAY rather than on the floor, so reaching it
-     * is reaching the door (for 2D6uZWqiWn9Mrhunc).
-     *
-     * Never applied to a barrier's keyItem -- INVARIANT 4 puts the key
-     * on the runner's side, and a key at the doorway behind its own
-     * seal is a bench nobody can work.
-     */
-    atDoorway?: boolean;
-    /** The long read, for a clue that carries a code. */
-    details?: string;
-    side?: ReproSide;
-}
-/**
- * THE FIXTURE SCHEMA'S VERSION, and the engine side is the source of
- * truth for it. Anything that GENERATES repro drafts -- the
- * maka-cli.com bench generator above all -- pins the version its prompt
- * was taught, and stamps that version on what it emits, so a draft
- * written against an older shape can be recognised instead of failing
- * mysteriously in validation.
- *
- * BUMPING:
- *   MINOR -- a new optional fixture field. Older drafts stay valid, so
- *            a generator pinned to an earlier minor keeps working.
- *   MAJOR -- an existing field changes MEANING, or stops being honoured.
- *            A generator pinned to an older major must be retaught.
- *
- * 2.0.0 IS THE VERSIONED BASELINE, NOT A BREAKING CHANGE. The original
- * schema shipped unversioned and is retroactively 1; this constant
- * starts the era in which the shape is declared rather than inferred.
- * The rule above governs everything AFTER 2.0.0 -- so the `host` and
- * `watched` fields introduced alongside it, being purely additive,
- * would themselves have been a MINOR bump had a version already
- * existed. Read it as "schema, second edition", not "second edition
- * broke something".
- */
-export declare const REPRO_SCHEMA_VERSION = "2.3.0";
-/** THE LIVE REASON, from the field or the card's own words.
- *
- *  `repro.live` is authoritative -- but the server's validator must
- *  learn the field before it flows, and the user could not tell hub
- *  from bench TODAY. So until every card carries the field, the known
- *  markers the cards already open with (a closed set, written by the
- *  operator's own hand) map to their labels. A bridge, not a guess:
- *  it recognises only the exact phrases in use, and the field wins the
- *  moment it exists. */
-export declare function liveReasonOf(repro: Pick<IRepro, 'live' | 'premise' | 'expect'> | undefined): string | undefined;
-/** Whether this bench demands a newer client than the one running.
- *
- *  Returns the version the reviewer must update TO, or undefined when
- *  the bench may run. Pure and total: an unreadable version string on
- *  EITHER side fails CLOSED (returns the lock), because "update to
- *  latest" is never the wrong advice, while guessing that a bench is
- *  runnable reproduces the exact double-rejection this lock exists to
- *  end. Prerelease tags are ignored -- releases here are plain
- *  major.minor.patch, and a dev tree's version equals the latest cut. */
-export declare function reproNeedsNewerCli(repro: Pick<IRepro, 'minVersion'>, currentVersion: string): string | undefined;
-export interface IReproFixture {
-    /** Plain-English framing, printed above the steps. */
-    premise?: string;
-    /** Names an ARCHETYPES entry and decides the pregen. Defaults to
-     *  Covert Ops, which carries the Lockpick Set and locksmith 5 -- so a
-     *  lock repro works without anyone having to think about it. */
-    archetype?: string;
-    /** Omitted for a repro that needs a scene and no obstacle. */
-    barrier?: IReproBarrier;
-    npcs?: IReproNpc[];
-    items?: IReproItem[];
-    /** Which side the runner starts on. Defaults to the barrier side. */
-    start?: ReproSide;
-    /**
-     * A SECOND STOREY on the barrier-side room -- a catwalk, balcony or
-     * mezzanine, with a spot standing on it.
-     *
-     * Added because elevation could not be benched at all: the builder
-     * made flat rooms, so a bench for "I don't know how to get up there"
-     * could only ever confirm the NEGATIVE (that ordinary rooms are
-     * unaffected). It also serves climb/descend, which is the next thing
-     * that needs to demonstrate going up.
-     *
-     * The spot is NOT optional and the builder will not let it be. A
-     * declared level with nothing standing on it is precisely the
-     * generation defect that produced these reports -- a storey the map
-     * draws and no string can reach -- so a fixture must not be able to
-     * reproduce it by accident while claiming to test the fix for it.
-     */
-    level?: {
-        /** Reads as the spot's name too: "catwalk" is a fine place to stand. */
-        name: string;
-        kind?: 'catwalk' | 'balcony' | 'mezzanine';
-        side?: 'north' | 'east' | 'south' | 'west';
-        /**
-         * NO LADDER -- the only way up is a free climb.
-         *
-         * Without this a bench cannot reach the climbing rules AT ALL. The
-         * grid synthesiser always builds a safe link (stairs or a ladder)
-         * beside the climb link, and findPath always prefers it -- by
-         * design, because a free climb is the last resort and not the
-         * default. So a level fixture demonstrates a ladder, which is the
-         * one route the climbing reports are not about: banking progress,
-         * surface modifiers, the hold-on and the catch are all on the
-         * branch a bench could not take.
-         *
-         * The same gap as the host one, one subsystem over: the fixture
-         * could not express the thing the report was about. Every test in
-         * climb-banking/climb-descent has to re-kind the vertical links by
-         * hand to reach it, which is fine in a unit test and impossible in
-         * a spec somebody types.
-         */
-        climbOnly?: boolean;
-    };
-    /**
-     * A MATRIX HOST on one of the rooms.
-     *
-     * Added because the whole Matrix family was ruled un-benchable: the
-     * builder made rooms with no node, so `hack`, `mark`, `snoop` and the
-     * grid's own naming had nothing to point at. Every one of those
-     * reports had to be demonstrated against a SHIPPED scene instead,
-     * which works but pins the bench to authored content that may be
-     * re-authored underneath it.
-     *
-     * Deliberately thin: hasNode, nodeAccess, hostRating and watched
-     * already exist on IRoomSeedJson and already carry these meanings, so
-     * this is plumbing, not new engine behaviour. Nothing here invents a
-     * rule the game did not already have.
-     */
-    host?: IReproHost;
-    /**
-     * Cameras with NO local host -- the thin-grid case.
-     *
-     * Only meaningful on its own: a room with a host is ALWAYS watched
-     * (a host has eyes on its own floor, see IRoomSeedJson.watched), so
-     * setting both says nothing the host did not already say.
-     */
-    watched?: boolean;
-}
-export interface IReproHost {
-    /**
-     * SR5 p.247 rates hosts 1-12: 1-2 street, 3-4 small business, 5-6
-     * corporate, 7-8 low-level government, 9-10 regional corporate and
-     * secure sites, 11-12 megacorporate HQ. Absent, the room takes
-     * Room.DEFAULT_HOST_RATING.
-     *
-     * Worth choosing deliberately on a bench: the rating IS the host's
-     * Matrix array (attack = rating+1 and so on), so it decides whether
-     * the reviewer's `hack` lands on the first try or reads as a fluke.
-     */
-    rating?: number;
-    /**
-     * 'wireless' (default) is an ordinary host, reachable by any jacked-in
-     * persona -- which is now every host, because a host is Matrix
-     * architecture by definition (hhSWzLSXECFtfoAGa).
-     *
-     * 'wired' IS LEGACY AND MEANS SOMETHING ELSE NOW. It no longer makes
-     * an air-gapped HOST -- there is no such thing. The Room constructor
-     * migrates it to an ordinary host PLUS an offline server device
-     * holding the files, reachable only by a direct connection with the
-     * actor's body in the room (p.233). Kept so old fixtures still build;
-     * prefer 'wireless' and place a server deliberately in new ones.
-     *
-     * (The claim that used to sit here -- "every host in the shipped
-     * scenes that holds paydata is air-gapped" -- was true of the old
-     * model and is now false twice over: the model is gone, and the scene
-     * prose that said so has been corrected.)
-     */
-    access?: 'wireless' | 'wired';
-    /** Which room carries it. Defaults to the side the runner starts on,
-     *  so `hack` has something to reach without walking first. */
-    side?: ReproSide;
-}
-export interface IRepro {
-    fixture?: IReproFixture;
-    /** THE RELEASE THIS BENCH IS REAL ON (user ruling 2026-08-29:
-     *  "version lock repros to the version it's fixed in").
-     *
-     *  A bench proves a fix, and the fix ships in a release -- run the
-     *  bench on an older client and it exercises the code from BEFORE
-     *  the fix, then reports the bug as unfixed. That is not
-     *  hypothetical: five items were rejected twice in one evening
-     *  because the reviewer's client predated the fixtures the benches
-     *  depended on.
-     *
-     *  Set it to the released version carrying the fix (and any builder
-     *  fixtures the spec uses). resolveReproTarget refuses to stand the
-     *  bench up on an older client and tells the reviewer to update
-     *  instead. Optional only for age: benches attached before this
-     *  field existed have no lock, not "no requirement". */
-    minVersion?: string;
-    /** AN INSTRUCTION CARD, NOT A LAUNCHABLE BENCH (user ruling
-     *  2026-08-30: "Rather than have me fire up a bench, to then just
-     *  have to quit, the bench should just read 'Hub Required'").
-     *
-     *  Some items cannot be staged -- heat needs a real run, crew needs a
-     *  real table, AI prose needs a live model -- and their repro is a
-     *  card of instructions. Before this field, such a card still
-     *  rendered "bench: maka play --repro <id>", booted a pointless
-     *  scene, and told the reviewer to go play live. Twice was enough.
-     *
-     *  The value is the SHORT REASON shown where the launch line would
-     *  be: "Hub Required", "Live AI required", "Shared run required".
-     *  Present = never boot; every surface prints the card in place
-     *  instead. Absent = a real bench that launches. */
-    live?: string;
-    /** Framing for the READER, printed above the steps.
-     *
-     *  Lives here and not only on the fixture because a repro can have no
-     *  fixture at all -- some items are about a verb or a menu -- and the
-     *  one line explaining what you are looking at should not depend on
-     *  there being a scene. When a fixture has none of its own, this
-     *  becomes the bench's story too. */
-    premise?: string;
-    /** The literal commands to type, in order -- and the same strings the
-     *  walkthrough test replays. Steps that only a human can read are
-     *  steps that rot. */
-    steps: string[];
-    /** What passing looks like. */
-    expect?: string;
-}

package/bundle/typescript/src/commands/game/sideQuest/types/repro.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"repro.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/types/repro.ts"],"names":[],"mappings":"AAoLA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAE5C;;;;;;;;wBAQwB;AACxB,MAAM,UAAU,YAAY,CAAC,KAA8D;IACzF,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,KAAK,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IAClC,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,KAAK,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3E,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,cAAc,CAAC;IACzD,IAAI,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,kBAAkB,CAAC;IACnG,IAAI,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAAE,OAAO,qBAAqB,CAAC;IACxE,IAAI,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QAAE,OAAO,oBAAoB,CAAC;IACxE,IAAI,IAAI,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAAE,OAAO,SAAS,CAAC,CAAC,2CAA2C;IACnH,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,OAAO,oBAAoB,CAAC;IACjE,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,OAAO,mBAAmB,CAAC;IAChE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;yEAQyE;AACzE,MAAM,UAAU,kBAAkB,CAAC,KAAiC,EAAE,cAAsB;IAC1F,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,CAAS,EAAwB,EAAE;QAChD,MAAM,CAAC,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}