@kamilmarzynski/scifi 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kamil Marzynski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,232 @@
+# scifi
+
+[![CI](https://github.com/KamilMarzynski/sci-fi/actions/workflows/ci.yml/badge.svg)](https://github.com/KamilMarzynski/sci-fi/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D22-brightgreen.svg)](https://nodejs.org)
+
+`scifi` is a specification-driven workflow for building software with a coding
+agent. It gives a feature a lifecycle — *spec → plan → implement → done* — and
+holds every stage to a written artifact and a review gate before it can advance.
+
+It is two cooperating layers:
+
+- A small **CLI** (`scifi`) that tracks each feature's lifecycle on disk and
+  refuses to skip a gate.
+- A set of bundled **skills** (`sf-*`) that your agent runs to do the actual
+  work — interrogating the idea, writing the spec, planning the design,
+  implementing it test-first, and reviewing each step.
+
+The CLI is the bookkeeping; the skills are the method. The CLI never refuses to
+let the agent advance unless an artifact is genuinely missing, and the skills
+never advance the lifecycle until a review has passed.
+
+> **On the name:** originally `spec-flow` (`sf` for short), now `scifi` — same
+> `sf`, spelled the fun way. The bundled skills keep their `sf-` prefix.
+
+## Requirements
+
+- Node.js `>=22`
+- A coding agent that supports skills (currently **Claude Code**)
+
+## Install
+
+```bash
+npm install -g @kamilmarzynski/scifi
+```
+
+Then, inside the repository you want to manage:
+
+```bash
+scifi init
+```
+
+`init` scaffolds the workspace under `docs/scifi/` and installs the skill
+catalog into your agent. For Claude Code that means `.claude/skills/sf-*/SKILL.md`
+for all 13 skills. It creates:
+
+```text
+docs/scifi/
+├── .scifi/config.json     # which harness you chose
+├── specs/                 # one folder per feature
+└── CONTEXT.md             # project glossary (ubiquitous language)
+```
+
+Skill files are owned by `scifi` — rerunning `init` overwrites them in place. To
+customize one, copy it under a different id (e.g. `my-code-review`) and edit that;
+your copy is never touched.
+
+## The lifecycle
+
+Every feature climbs the same one-way ladder. Each step is gated: the CLI checks
+that the backing artifact exists before it lets the status advance.
+
+```text
+created ──spec.md──► spec-ready ──design.md+tasks──► plan-ready ──► in-progress ──► done
+```
+
+| Status        | Means                          | Gate to reach it                     |
+| ------------- | ------------------------------ | ------------------------------------ |
+| `created`     | container exists, no spec yet  | `scifi spec <slug>`                  |
+| `spec-ready`  | spec written and reviewed      | `spec.md` exists                     |
+| `plan-ready`  | design + tasks written         | `design.md` and ≥1 task file exist   |
+| `in-progress` | implementation started         | reachable only from `plan-ready`     |
+| `done`        | built, verified, closed out    | all tasks done **and** no open fixes |
+
+You never jump the ladder. A scope change that invalidates the spec rolls the
+feature back to `spec-ready` and it climbs again through every gate.
+
+## How to use it (the everyday flow)
+
+Work is driven by invoking skills in your agent. The CLI calls happen *inside*
+the skills — you rarely type `scifi` commands by hand except to inspect state.
+
+**1. Start a feature.** Run the `sf-feature` skill. It creates the container,
+then grills you about the idea one question at a time — the real problem, what is
+out of scope, testable acceptance criteria, the edge cases — until the spec has
+no gaps. It writes `spec.md`, runs a spec review, and marks the feature
+`spec-ready`.
+
+**2. Plan it.** Run `sf-plan`. It grills the *how* against your codebase, pushing
+for deep modules (lots of behavior behind a narrow interface). It writes
+`design.md`, decomposes the work into test-first task files ordered by a
+`depends-on` graph, runs a plan review, and marks the feature `plan-ready`.
+
+**3. Implement it.** Run `sf-implement`. This stage is autonomous. It dispatches a
+fresh subagent per task — each builds its slice test-first (`sf-tdd`) and is
+gated by an independent code review before the task is marked done. When all
+tasks pass, a handover subagent verifies the whole feature against the spec and
+design, runs your checks, and the feature is finished.
+
+That is the spine. The other skills handle the situations that come up around it:
+
+| When…                                  | Run…           |
+| -------------------------------------- | -------------- |
+| You picked up work and forgot where it was | `sf-continue` — reads the status and routes you to the right next step |
+| The feature's scope changed            | `sf-change` — rolls the feature back exactly as far as the change cuts, then re-enters |
+| You hit a defect with no owning feature | `sf-bug` — investigate-then-fix, no tracked artifact |
+| You hit a defect in a real feature     | `sf-fix` — same, but records a tracked fix that blocks `finish` until resolved |
+
+**Inspect state any time** with the CLI directly:
+
+```bash
+scifi list                 # all features, status, open-fix counts
+scifi status <slug>        # full inventory: artifacts, tasks, fixes
+scifi task list <slug>     # the task graph and each task's status
+```
+
+## What makes it work
+
+A few ideas recur through every stage and are worth understanding:
+
+- **Grill before write.** Spec and plan sessions are interactive interrogations,
+  not form-filling. The artifact is written only once every question is answered
+  — no `TBD`, no `TODO`.
+- **Review gates, not trust.** Every artifact (spec, plan, each task) is reviewed
+  by a separate subagent with clean context before the lifecycle advances. The
+  reviewer judges; the author acts on the findings under `sf-receiving-review`
+  (verify, push back when wrong, no performative agreement). The loop repeats
+  until the verdict is **Pass**.
+- **Test-first implementation.** No production code without a failing test first
+  (`sf-tdd`). The test proves the behavior exists; the regression test proves a
+  fixed bug stays fixed.
+- **Clean subagent context.** The orchestrator never lets a subagent read its
+  session history. Each subagent's context is built from the artifacts alone, so
+  reviews stay unbiased and the coordinator stays focused.
+- **Deep modules.** Planning and review both push for narrow interfaces over deep
+  implementations, and apply the *deletion test*: would removing a unit
+  concentrate complexity (keep it) or just scatter it (inline it)?
+- **Isolated per feature.** Starting a feature with `sf-feature` creates its own
+  git branch (`feat/<slug>`) and worktree (`.worktrees/feat-<slug>`) up front, so
+  several features can be built in parallel without colliding, and nothing lands
+  on the default branch until the feature's PR merges. `scifi status` reports the
+  branch and worktree; the maintainer removes the worktree after the PR merges.
+
+## Project conventions
+
+These live under `docs/scifi/` and the skills read and maintain them:
+
+- **`CONTEXT.md`** — the project glossary (ubiquitous language). Every domain
+  term used in a spec is defined here; the skills add terms as they appear, so
+  naming stays consistent across features.
+- **`adr/NNNN-slug.md`** — Architecture Decision Records. The directory is lazy
+  (created on the first record). A decision is recorded only when it is
+  hard to reverse, non-obvious, and a real trade-off was made. Skills grep these
+  before contradicting a past decision.
+- **`HANDOVER.md`** *(optional)* — finishing actions the implement stage runs
+  after handover verification passes and before the feature is finished: smoke
+  tests, opening a pull request, invoking your release skill. Create it yourself
+  when you want it; absent, the feature finishes with no extra actions.
+- **`specs/<slug>/`** — one feature: `spec.md`, `design.md`, `tasks/*.md`,
+  `fixes/*.md`, and the CLI-managed `.scifi.json` metadata.
+
+## The skills
+
+`init` installs all 13. The first seven are the ones you invoke directly; the
+rest are dispatched by other skills as subagents.
+
+| Skill                | Role                                                            |
+| -------------------- | -------------------------------------------------------------- |
+| `sf-feature`         | Grill a new idea and write the spec                            |
+| `sf-plan`            | Grill the design and decompose into tasks                      |
+| `sf-implement`       | Orchestrate test-first implementation, task by task            |
+| `sf-continue`        | Route a picked-up feature to its next step                     |
+| `sf-change`          | Absorb a scope change; roll the lifecycle back as far as needed |
+| `sf-bug`             | Investigate and fix a defect (untracked)                       |
+| `sf-fix`             | Investigate and fix a defect anchored to a feature (tracked)   |
+| `sf-tdd`             | Test-first discipline held by implementer subagents            |
+| `sf-spec-review`     | Critique a spec before `spec-ready`                            |
+| `sf-plan-review`     | Critique a plan before `plan-ready`                            |
+| `sf-code-review`     | Critique one task's code before it is marked done              |
+| `sf-receiving-review`| How an author acts on a review                                 |
+| `sf-handover`        | Verify a completed feature against its spec and design         |
+
+## CLI reference
+
+| Command                                    | Effect                                              |
+| ------------------------------------------ | --------------------------------------------------- |
+| `scifi init`                               | Scaffold the workspace and install skills           |
+| `scifi spec <slug> [--title "..."]`        | Create a feature container (status `created`)       |
+| `scifi spec-ready <slug>`                  | `created → spec-ready` (needs `spec.md`)            |
+| `scifi plan <slug>`                        | Report planning progress (read-only)                |
+| `scifi plan-ready <slug>`                  | `spec-ready → plan-ready` (needs design + tasks)    |
+| `scifi start <slug>`                       | `plan-ready → in-progress`                          |
+| `scifi task list\|start\|done <slug> ...`  | Manage task status within a feature                 |
+| `scifi fix create\|resolve\|wont-fix ...`  | Manage tracked fixes (open fixes block `finish`)    |
+| `scifi finish <slug>`                      | `in-progress → done` (all tasks done, no open fixes)|
+| `scifi list [--status <s>]`                | List features                                       |
+| `scifi status <slug>`                      | Show a feature's full state                         |
+| `scifi worktree set <slug> --branch <b> --path <p>` | Record the branch + worktree backing a feature |
+
+Every command accepts `--json` for structured output, and reports failures with
+a stable error code (`NOT_FOUND`, `PRECONDITION_FAILED`, `CONFLICT`,
+`INVALID_ARGUMENT`).
+
+## Development
+
+```bash
+npm install
+npm run typecheck
+npm run build
+npm test
+npm run coverage
+npm run check        # Biome lint + format
+```
+
+User-facing CLI changes are verified against an installed build, not only
+source-level tests. That workflow lives under `.testing/` and is covered by
+`tests/e2e/`; see `TESTING.md` for the mandatory process.
+
+## Contributing
+
+Contributions are welcome. See [CONTRIBUTING.md](./CONTRIBUTING.md) for the dev
+setup, branch/commit conventions, and verification steps. By participating you
+agree to the [Code of Conduct](./CODE_OF_CONDUCT.md). To report a security issue,
+follow [SECURITY.md](./SECURITY.md) — do not open a public issue.
+
+Releases are automated with [release-please](https://github.com/googleapis/release-please):
+merged [Conventional Commits](https://www.conventionalcommits.org/) drive the
+version bump and changelog, and merging the Release PR publishes to npm.
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/skills/sf-bug/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { SkillManifest } from "scifi/skill-types";
+export declare const manifest: SkillManifest;

package/dist/skills/sf-bug/manifest.js

@@ -0,0 +1,6 @@
+export const manifest = {
+    id: "sf-bug",
+    description: "Investigate one bug with the user, agree on a solution, then fix it test-first under review. No spec or tracked artifact.",
+    argumentHint: "[description]",
+};
+//# sourceMappingURL=manifest.js.map

package/dist/skills/sf-bug/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../skills/sf-bug/manifest.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,EAAE,EAAE,QAAQ;IACZ,WAAW,EACT,2HAA2H;IAC7H,YAAY,EAAE,eAAe;CAC9B,CAAC"}

package/dist/skills/sf-change/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { SkillManifest } from "scifi/skill-types";
+export declare const manifest: SkillManifest;

package/dist/skills/sf-change/manifest.js

@@ -0,0 +1,6 @@
+export const manifest = {
+    id: "sf-change",
+    description: "Absorb a scope change to an existing feature: scope it against spec/design, reset lifecycle status to the deepest artifact it invalidates, and re-enter the pipeline so the right review gate runs again.",
+    argumentHint: "[feature-slug | description]",
+};
+//# sourceMappingURL=manifest.js.map

package/dist/skills/sf-change/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../skills/sf-change/manifest.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,EAAE,EAAE,WAAW;IACf,WAAW,EACT,2MAA2M;IAC7M,YAAY,EAAE,8BAA8B;CAC7C,CAAC"}

package/dist/skills/sf-code-review/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { SkillManifest } from "scifi/skill-types";
+export declare const manifest: SkillManifest;

package/dist/skills/sf-code-review/manifest.js

@@ -0,0 +1,5 @@
+export const manifest = {
+    id: "sf-code-review",
+    description: "Read-only critic pass on one change: a feature task against design.md + the task's acceptance, or a bug/fix against the agreed solution. Returns a verdict that gates acceptance.",
+};
+//# sourceMappingURL=manifest.js.map

package/dist/skills/sf-code-review/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../skills/sf-code-review/manifest.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,EAAE,EAAE,gBAAgB;IACpB,WAAW,EACT,mLAAmL;CACtL,CAAC"}

package/dist/skills/sf-continue/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { SkillManifest } from "scifi/skill-types";
+export declare const manifest: SkillManifest;

package/dist/skills/sf-continue/manifest.js

@@ -0,0 +1,6 @@
+export const manifest = {
+    id: "sf-continue",
+    description: "Resume an interrupted feature. Reads `scifi status <slug> --json`, determines the next workflow step from lifecycle status, and runs the matching skill, pausing where human handoff is required.",
+    argumentHint: "[feature-slug | description]",
+};
+//# sourceMappingURL=manifest.js.map

package/dist/skills/sf-continue/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../skills/sf-continue/manifest.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,EAAE,EAAE,aAAa;IACjB,WAAW,EACT,mMAAmM;IACrM,YAAY,EAAE,8BAA8B;CAC7C,CAAC"}

package/dist/skills/sf-feature/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { SkillManifest } from "scifi/skill-types";
+export declare const manifest: SkillManifest;

package/dist/skills/sf-feature/manifest.js

@@ -0,0 +1,6 @@
+export const manifest = {
+    id: "sf-feature",
+    description: "Start grilling session for new feature. Greps docs/scifi/adr/ for relevant decisions; records an ADR only for hard, non-obvious choices. Writes spec.md.",
+    argumentHint: "[title]",
+};
+//# sourceMappingURL=manifest.js.map

package/dist/skills/sf-feature/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../skills/sf-feature/manifest.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,EAAE,EAAE,YAAY;IAChB,WAAW,EACT,0JAA0J;IAC5J,YAAY,EAAE,SAAS;CACxB,CAAC"}

package/dist/skills/sf-fix/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { SkillManifest } from "scifi/skill-types";
+export declare const manifest: SkillManifest;

package/dist/skills/sf-fix/manifest.js

@@ -0,0 +1,6 @@
+export const manifest = {
+    id: "sf-fix",
+    description: "Fix a defect in an existing feature: diagnose against its spec/design with the user, agree on a solution, then fix it test-first under review and record a tracked fix.",
+    argumentHint: "[feature-slug | description]",
+};
+//# sourceMappingURL=manifest.js.map

package/dist/skills/sf-fix/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../skills/sf-fix/manifest.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,EAAE,EAAE,QAAQ;IACZ,WAAW,EACT,yKAAyK;IAC3K,YAAY,EAAE,8BAA8B;CAC7C,CAAC"}

package/dist/skills/sf-handover/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { SkillManifest } from "scifi/skill-types";
+export declare const manifest: SkillManifest;

package/dist/skills/sf-handover/manifest.js

@@ -0,0 +1,5 @@
+export const manifest = {
+    id: "sf-handover",
+    description: "Final implementation subagent. Verifies the completed feature against spec + design and runs a quality check before handover. Aware of the optional HANDOVER.md finishing actions the orchestrator runs.",
+};
+//# sourceMappingURL=manifest.js.map

package/dist/skills/sf-handover/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../skills/sf-handover/manifest.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,EAAE,EAAE,aAAa;IACjB,WAAW,EACT,0MAA0M;CAC7M,CAAC"}

package/dist/skills/sf-implement/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { SkillManifest } from "scifi/skill-types";
+export declare const manifest: SkillManifest;

package/dist/skills/sf-implement/manifest.js

@@ -0,0 +1,6 @@
+export const manifest = {
+    id: "sf-implement",
+    description: "Orchestrate implementation of a plan-ready feature. Dispatches one TDD subagent per task in dependency order, gates each on code review, then runs handover (sf-handover verification + optional HANDOVER.md actions) before finish.",
+    argumentHint: "[feature-slug]",
+};
+//# sourceMappingURL=manifest.js.map

package/dist/skills/sf-implement/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../skills/sf-implement/manifest.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,EAAE,EAAE,cAAc;IAClB,WAAW,EACT,sOAAsO;IACxO,YAAY,EAAE,gBAAgB;CAC/B,CAAC"}

package/dist/skills/sf-plan/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { SkillManifest } from "scifi/skill-types";
+export declare const manifest: SkillManifest;

package/dist/skills/sf-plan/manifest.js

@@ -0,0 +1,6 @@
+export const manifest = {
+    id: "sf-plan",
+    description: "Deep technical planning from approved spec.md. Writes design.md + tasks/. Greps docs/scifi/adr/ for context; records an ADR for hard, non-obvious decisions.",
+    argumentHint: "[feature-slug]",
+};
+//# sourceMappingURL=manifest.js.map

package/dist/skills/sf-plan/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../skills/sf-plan/manifest.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,EAAE,EAAE,SAAS;IACb,WAAW,EACT,8JAA8J;IAChK,YAAY,EAAE,gBAAgB;CAC/B,CAAC"}

package/dist/skills/sf-plan-review/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { SkillManifest } from "scifi/skill-types";
+export declare const manifest: SkillManifest;

package/dist/skills/sf-plan-review/manifest.js

@@ -0,0 +1,5 @@
+export const manifest = {
+    id: "sf-plan-review",
+    description: "Critic pass on design.md + tasks/. Checks spec coverage and declared seams.",
+};
+//# sourceMappingURL=manifest.js.map

package/dist/skills/sf-plan-review/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../skills/sf-plan-review/manifest.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,EAAE,EAAE,gBAAgB;IACpB,WAAW,EACT,6EAA6E;CAChF,CAAC"}

package/dist/skills/sf-receiving-review/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { SkillManifest } from "scifi/skill-types";
+export declare const manifest: SkillManifest;

package/dist/skills/sf-receiving-review/manifest.js

@@ -0,0 +1,5 @@
+export const manifest = {
+    id: "sf-receiving-review",
+    description: "How to act on a review (spec, plan, or code). Verify before implementing, fix by severity, push back with technical reasoning when the reviewer is wrong.",
+};
+//# sourceMappingURL=manifest.js.map

package/dist/skills/sf-receiving-review/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../skills/sf-receiving-review/manifest.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,EAAE,EAAE,qBAAqB;IACzB,WAAW,EACT,2JAA2J;CAC9J,CAAC"}

package/dist/skills/sf-spec-review/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { SkillManifest } from "scifi/skill-types";
+export declare const manifest: SkillManifest;

package/dist/skills/sf-spec-review/manifest.js

@@ -0,0 +1,5 @@
+export const manifest = {
+    id: "sf-spec-review",
+    description: "Critic pass on a spec.md. Surfaces ambiguity, missing AC, CONTEXT.md gaps.",
+};
+//# sourceMappingURL=manifest.js.map

package/dist/skills/sf-spec-review/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../skills/sf-spec-review/manifest.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,EAAE,EAAE,gBAAgB;IACpB,WAAW,EACT,4EAA4E;CAC/E,CAAC"}

package/dist/skills/sf-tdd/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { SkillManifest } from "scifi/skill-types";
+export declare const manifest: SkillManifest;

package/dist/skills/sf-tdd/manifest.js

@@ -0,0 +1,5 @@
+export const manifest = {
+    id: "sf-tdd",
+    description: "Tests-first implementation discipline for a single task. Red-green-refactor in vertical slices; no production code without a failing test first.",
+};
+//# sourceMappingURL=manifest.js.map

package/dist/skills/sf-tdd/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../skills/sf-tdd/manifest.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,EAAE,EAAE,QAAQ;IACZ,WAAW,EACT,kJAAkJ;CACrJ,CAAC"}

package/dist/skills/sf-verification/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { SkillManifest } from "scifi/skill-types";
+export declare const manifest: SkillManifest;

package/dist/skills/sf-verification/manifest.js

@@ -0,0 +1,5 @@
+export const manifest = {
+    id: "sf-verification",
+    description: "Verify implementation matches spec + plan. Runs user validations from EVALUATION.md.",
+};
+//# sourceMappingURL=manifest.js.map

package/dist/skills/sf-verification/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../skills/sf-verification/manifest.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,EAAE,EAAE,iBAAiB;IACrB,WAAW,EACT,sFAAsF;CACzF,CAAC"}

package/dist/src/cli/commands/bug.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerBugCommand(program: Command): void;

package/dist/src/cli/commands/bug.js

@@ -0,0 +1,58 @@
+import { relative } from 'node:path';
+import { cwd } from 'node:process';
+import { createBug } from '../../core/bugs/create.js';
+import { BUG_SEVERITY_VALUES } from '../../core/bugs/types.js';
+import { emitError, emitSuccess, jsonMode, ScifiError } from '../../core/output/index.js';
+function createTimestamp() {
+    return new Date().toISOString();
+}
+export function registerBugCommand(program) {
+    program
+        .command('bug')
+        .description('Create a standalone bug report in the root bugs/ directory')
+        .argument('<description>', 'short description of the bug')
+        .option('--related-feature <slug>', 'feature slug for context')
+        .option('--severity <level>', 'severity level: low, medium, high, or critical')
+        .option('--json', 'output as structured JSON')
+        .action(async (description, options, command) => {
+        const json = jsonMode(command);
+        try {
+            if (options.severity !== undefined &&
+                !BUG_SEVERITY_VALUES.includes(options.severity)) {
+                throw new ScifiError('INVALID_ARGUMENT', `Invalid severity "${options.severity}".`, {
+                    hint: `Must be one of: ${BUG_SEVERITY_VALUES.join(', ')}.`,
+                });
+            }
+            const severity = options.severity;
+            const projectRoot = cwd();
+            const result = await createBug({
+                projectRoot,
+                description,
+                ...(options.relatedFeature !== undefined && {
+                    relatedFeature: options.relatedFeature,
+                }),
+                ...(severity !== undefined && { severity }),
+                now: createTimestamp(),
+            });
+            const path = relative(projectRoot, result.filePath);
+            emitSuccess({
+                action: 'bug',
+                id: result.id,
+                description,
+                severity: severity ?? null,
+                path,
+                relatedFeature: options.relatedFeature ?? null,
+            }, json, [
+                `Bug created: ${result.id}`,
+                `  Description: ${description}`,
+                `  Severity: ${severity ?? 'unspecified'}`,
+                `  Path: ${path}`,
+                `  Related feature: ${options.relatedFeature ?? 'none'}`,
+            ]);
+        }
+        catch (error) {
+            emitError(error, json);
+        }
+    });
+}
+//# sourceMappingURL=bug.js.map

package/dist/src/cli/commands/bug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bug.js","sourceRoot":"","sources":["../../../../src/cli/commands/bug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAoB,MAAM,0BAA0B,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE1F,SAAS,eAAe;IACtB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,4DAA4D,CAAC;SACzE,QAAQ,CAAC,eAAe,EAAE,8BAA8B,CAAC;SACzD,MAAM,CAAC,0BAA0B,EAAE,0BAA0B,CAAC;SAC9D,MAAM,CAAC,oBAAoB,EAAE,gDAAgD,CAAC;SAC9E,MAAM,CAAC,QAAQ,EAAE,2BAA2B,CAAC;SAC7C,MAAM,CACL,KAAK,EACH,WAAmB,EACnB,OAIC,EACD,OAAgB,EAChB,EAAE;QACF,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC;YACH,IACE,OAAO,CAAC,QAAQ,KAAK,SAAS;gBAC9B,CAAE,mBAAyC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,EACtE,CAAC;gBACD,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,qBAAqB,OAAO,CAAC,QAAQ,IAAI,EAAE;oBAClF,IAAI,EAAE,mBAAmB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;iBAC3D,CAAC,CAAC;YACL,CAAC;YACD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAmC,CAAC;YAE7D,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC;gBAC7B,WAAW;gBACX,WAAW;gBACX,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,IAAI;oBAC1C,cAAc,EAAE,OAAO,CAAC,cAAc;iBACvC,CAAC;gBACF,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;gBAC3C,GAAG,EAAE,eAAe,EAAE;aACvB,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YACpD,WAAW,CACT;gBACE,MAAM,EAAE,KAAK;gBACb,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,WAAW;gBACX,QAAQ,EAAE,QAAQ,IAAI,IAAI;gBAC1B,IAAI;gBACJ,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;aAC/C,EACD,IAAI,EACJ;gBACE,gBAAgB,MAAM,CAAC,EAAE,EAAE;gBAC3B,kBAAkB,WAAW,EAAE;gBAC/B,eAAe,QAAQ,IAAI,aAAa,EAAE;gBAC1C,WAAW,IAAI,EAAE;gBACjB,sBAAsB,OAAO,CAAC,cAAc,IAAI,MAAM,EAAE;aACzD,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CACF,CAAC;AACN,CAAC"}

package/dist/src/cli/commands/finish.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerFinishCommand(program: Command): void;

package/dist/src/cli/commands/finish.js

@@ -0,0 +1,43 @@
+import { cwd } from 'node:process';
+import { listOpenFixes } from '../../core/fixes/list.js';
+import { emitError, emitSuccess, jsonMode, ScifiError } from '../../core/output/index.js';
+import { updateFeatureStatus } from '../../core/specs/transition.js';
+function createTimestamp() {
+    return new Date().toISOString();
+}
+export function registerFinishCommand(program) {
+    program
+        .command('finish')
+        .description('Mark a feature as done (requires all tasks done and no open fixes)')
+        .argument('<slug>', 'feature folder slug')
+        .option('--json', 'output as structured JSON')
+        .action(async (slug, _options, command) => {
+        const json = jsonMode(command);
+        try {
+            const projectRoot = cwd();
+            const openFixes = await listOpenFixes(projectRoot, slug);
+            if (openFixes.length > 0) {
+                const ids = openFixes.map((f) => f.id).join(', ');
+                throw new ScifiError('PRECONDITION_FAILED', `Cannot finish ${slug}: ${openFixes.length} open fix${openFixes.length === 1 ? '' : 'es'} block completion`, {
+                    hint: `Resolve or mark wont-fix the following fixes: ${ids}`,
+                    details: {
+                        openFixes: openFixes.map((f) => ({
+                            id: f.id,
+                            status: f.status,
+                            slug: f.slug,
+                        })),
+                    },
+                });
+            }
+            const result = await updateFeatureStatus(projectRoot, slug, 'done', createTimestamp());
+            emitSuccess({ action: 'finish', ...result }, json, [
+                `feature ${result.slug}: ${result.previousStatus} → ${result.newStatus}`,
+                `  Timestamp: ${result.timestamp}`,
+            ]);
+        }
+        catch (error) {
+            emitError(error, json);
+        }
+    });
+}
+//# sourceMappingURL=finish.js.map

package/dist/src/cli/commands/finish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish.js","sourceRoot":"","sources":["../../../../src/cli/commands/finish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,SAAS,eAAe;IACtB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,oEAAoE,CAAC;SACjF,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;SACzC,MAAM,CAAC,QAAQ,EAAE,2BAA2B,CAAC;SAC7C,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,QAAiB,EAAE,OAAgB,EAAE,EAAE;QAClE,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAEzD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClD,MAAM,IAAI,UAAU,CAClB,qBAAqB,EACrB,iBAAiB,IAAI,KAAK,SAAS,CAAC,MAAM,YAAY,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,mBAAmB,EAC3G;oBACE,IAAI,EAAE,iDAAiD,GAAG,EAAE;oBAC5D,OAAO,EAAE;wBACP,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BAC/B,EAAE,EAAE,CAAC,CAAC,EAAE;4BACR,MAAM,EAAE,CAAC,CAAC,MAAM;4BAChB,IAAI,EAAE,CAAC,CAAC,IAAI;yBACb,CAAC,CAAC;qBACJ;iBACF,CACF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;YACvF,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE;gBACjD,WAAW,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,cAAc,MAAM,MAAM,CAAC,SAAS,EAAE;gBACxE,gBAAgB,MAAM,CAAC,SAAS,EAAE;aACnC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/cli/commands/fix.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerFixCommand(program: Command): void;