buildkeel 0.4.0 → 0.6.0

package/antigravity/templates/spec-driven/tasks.md

@@ -1,6 +1,6 @@
 ---
 template: tasks
-version: 1
+version: 2
 description: The work of a change, as numbered tasks in groups ordered so that each builds on the ones before. A task is ticked once its verification passes.
 fields:
   parent: { required: true, type: link }
@@ -9,9 +9,17 @@ fields:
 ## 1. <What this group delivers>
 
 <!--
-One checkbox per task, numbered within its group, each saying what is done and how its completion is verified.
-Each group includes the tests and documentation its own work needs. Tick a task only once its verification passed.
+One checkbox per task, numbered within its group, saying what is done, with its lines under it: Files (what it creates, changes and tests), Uses (each with where it comes from: an earlier task, a file, or a library at the version the project depends on), Delivers (what later tasks rely on, with its signature), and Verify (the command and the result expected, naming the scenarios it checks). Interfaces: none stands for Uses and Delivers when a task uses and delivers nothing. Leave the code itself out.
+Each group includes the tests and documentation its own work needs. Tick a task only once its verification passed; its Built line is written then.
 
-- [ ] 1.1 Add the issue time to reset tokens. Verify: token tests for a new and an old token.
-- [ ] 1.2 Refuse links older than 30 minutes. Verify: the "Expired link" scenario test (AUTH-R3-S1).
+- [ ] 1.1 Add the issue time to reset tokens.
+  Files: change src/auth/token.ts; test test/auth/token.test.ts
+  Uses: signToken (from src/auth/sign.ts)
+  Delivers: issuedAt on ResetToken
+  Verify: npx vitest run test/auth/token.test.ts, where the tests for a new and an old token pass
+- [ ] 1.2 Refuse links older than 30 minutes.
+  Files: change src/auth/reset.ts; test test/auth/reset.test.ts
+  Uses: issuedAt on ResetToken (from 1.1)
+  Delivers: isExpired(token: ResetToken, now: Date): boolean
+  Verify: npx vitest run test/auth/reset.test.ts, where [AUTH-R3-S1] passes
 -->

package/antigravity/templates/task.md

@@ -1,6 +1,6 @@
 ---
 template: task
-version: 1
+version: 2
 description: A piece of a story built in one code repository.
 fields:
   title: { required: true }
@@ -9,13 +9,34 @@ fields:
   scope: { type: list }
 sections:
   Description: { required: true, tracked: true }
+  Files: { required: true }
+  Uses: { required: true }
+  Delivers: { required: true }
+  Verify: { required: true }
+  Interfaces: { offered: "none, in place of Uses and Delivers, for a task that uses and delivers nothing." }
   Open questions: { offered: "Questions left open, each with what it is about, to settle later. They do not block approval: the approval summary lists them." }
   Notes: {}
 ---
 
 ## Description
 
-<!-- What to build. Name the repository in the repo field, and list the paths it will touch in the scope field when you know them. -->
+<!-- What to build. Name the repository in the repo field, and list the paths it will touch in the scope field when you know them. Leave the code itself out: only what the implementer cannot decide alone, such as names, signatures and values from the spec. -->
+
+## Files
+
+<!-- The files it creates, changes and tests, found from the code, one per line, such as "- create: src/auth/expiry.ts", "- change: src/auth/reset.ts" and "- test: test/auth/reset.test.ts". -->
+
+## Uses
+
+<!-- What it uses, each with where it comes from (an earlier task, a file, or a library at the version the project depends on), such as "- issuedAt on ResetToken (from TK-011)", "- parseToken (from src/auth/tokens.ts)" or "- messages.create (from twilio 4.23.0)"; none when it uses nothing. -->
+
+## Delivers
+
+<!-- What later tasks rely on, with its signature, such as "- isExpired(token: ResetToken, now: Date): boolean", or none; this is the plan, and what is built is recorded when the task is finished. -->
+
+## Verify
+
+<!-- The command to run and the result expected, naming the test cases it checks, such as "npx vitest run test/auth/reset.test.ts, where [US-012-TC3] passes". -->
 
 ## Notes
 

package/antigravity/templates/thread.md

@@ -0,0 +1,41 @@
+---
+template: thread
+version: 1
+description: A paused exploration with no unit or change yet, saved so it can be resumed. It has no stages and no approval; it ends when it is captured or dropped.
+fields:
+  title: { required: true }
+sections:
+  Intent: { required: true }
+  Approaches: { required: true }
+  Decisions and constraints: { required: true }
+  Dead ends and open questions: { required: true }
+  Next: { required: true }
+  The user's words: { required: true }
+  Code read: { offered: "Pointers to the code that was read, one per line: the file, with the lines or names that mattered." }
+  Spikes: { offered: "Each spike: its branch, or the files it left, and what it showed." }
+  Notes: { offered: "Background, links, and anything that fits no other section." }
+---
+
+## Intent
+
+<!-- What the user wants to achieve, and the idea as it stands. -->
+
+## Approaches
+
+<!-- The approaches discussed, and which way the discussion is leaning. "None weighed yet" when there were none. -->
+
+## Decisions and constraints
+
+<!-- What was settled, and the limits the work must respect. "None yet" when there are none. -->
+
+## Dead ends and open questions
+
+<!-- What was tried or ruled out, with why, and the questions still open. -->
+
+## Next
+
+<!-- The next thing to discuss when the thread is resumed. -->
+
+## The user's words
+
+<!-- The user's own statements that matter, quoted, kept apart from the agent's proposals. -->