@open-tomato/rafa 0.45.0 → 0.47.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +285 -23
- package/dist/PROMPT.md +18 -1
- package/dist/adapters/logger/settings.d.ts +132 -0
- package/dist/bugs/closest.d.ts +19 -0
- package/dist/bugs/fenced.d.ts +8 -0
- package/dist/bugs/places.d.ts +20 -0
- package/dist/bugs/record.d.ts +145 -0
- package/dist/bugs/title.d.ts +83 -0
- package/dist/bundled/agents/doc-updater.md +17 -3
- package/dist/bundled/agents/loop-implementer.md +14 -2
- package/dist/bundled/operators/skills/rafa-stretch-pit-stop/SKILL.md +10 -3
- package/dist/bundled/operators/skills/rafa-stretch-sweep/SKILL.md +5 -0
- package/dist/bundled/skills/dev-planner/SKILL.md +101 -18
- package/dist/cli.js +76536 -64285
- package/dist/config/entry.d.ts +119 -0
- package/dist/config/index.d.ts +41 -0
- package/dist/config/index.js +54 -0
- package/dist/config/shape.d.ts +235 -0
- package/dist/config/templates.d.ts +64 -0
- package/dist/config-registry.d.ts +136 -0
- package/dist/config-schema-board-project.d.ts +157 -0
- package/dist/config-schema-bugs.d.ts +71 -0
- package/dist/config-schema-checks.d.ts +114 -0
- package/dist/config-schema-errors.d.ts +54 -0
- package/dist/config-schema-features.d.ts +64 -0
- package/dist/config-schema-hub.d.ts +152 -0
- package/dist/config-schema-issues.d.ts +95 -0
- package/dist/config-schema-logger.d.ts +91 -0
- package/dist/config-schema-loop-continue.d.ts +122 -0
- package/dist/config-schema-loop-retries.d.ts +94 -0
- package/dist/config-schema-release.d.ts +306 -0
- package/dist/config-schema-tests.d.ts +178 -0
- package/dist/config-schema-triage.d.ts +142 -0
- package/dist/config-schema-wrap-up.d.ts +96 -0
- package/dist/core/command/command.d.ts +228 -0
- package/dist/core/command/confirm.d.ts +73 -0
- package/dist/core/command/index.d.ts +130 -0
- package/dist/core/command/lazy.d.ts +54 -0
- package/dist/core/command/registry-types.d.ts +96 -0
- package/dist/core/command/running.d.ts +96 -0
- package/dist/core/command/shared-flags.d.ts +40 -0
- package/dist/core/command/spends.d.ts +39 -0
- package/dist/core/command/types.d.ts +92 -0
- package/dist/core/command/version.d.ts +4 -0
- package/dist/core/config/branch-template.d.ts +20 -0
- package/dist/core/config/config-items.d.ts +86 -0
- package/dist/core/config/config-load-module.d.ts +43 -0
- package/dist/core/config/config-load.d.ts +78 -0
- package/dist/core/config/config-origins.d.ts +58 -0
- package/dist/core/config/config-readers.d.ts +167 -0
- package/dist/core/config/config-schema.d.ts +212 -0
- package/dist/core/config/config-sections.d.ts +493 -0
- package/dist/core/config/config.d.ts +385 -0
- package/dist/core/config/core-section.d.ts +39 -0
- package/dist/core/config/dangerous.d.ts +58 -0
- package/dist/core/config/default-routing.d.ts +16 -0
- package/dist/core/config/index.d.ts +145 -0
- package/dist/core/config/merge-method.d.ts +40 -0
- package/dist/core/config/scope.d.ts +42 -0
- package/dist/core/config/section.d.ts +286 -0
- package/dist/core/config/sections.d.ts +53 -0
- package/dist/core/config/standard-schema.d.ts +27 -0
- package/dist/core/git/commit.d.ts +232 -0
- package/dist/core/git/gh-runner.d.ts +24 -0
- package/dist/core/git/git.d.ts +22 -0
- package/dist/core/git/index.d.ts +85 -0
- package/dist/core/loop/claude.d.ts +388 -0
- package/dist/core/loop/hop-record.d.ts +52 -0
- package/dist/core/loop/index.d.ts +179 -0
- package/dist/core/loop/session-env.d.ts +20 -0
- package/dist/core/loop/session-record-parse.d.ts +70 -0
- package/dist/core/loop/sessions.d.ts +420 -0
- package/dist/core/loop/suite-failure.d.ts +25 -0
- package/dist/core/output/active.d.ts +100 -0
- package/dist/core/output/stream.d.ts +20 -0
- package/dist/core/output/text.d.ts +55 -0
- package/dist/core/plan/block-reader.d.ts +46 -0
- package/dist/core/plan/blocks.d.ts +139 -0
- package/dist/core/plan/declaration.d.ts +366 -0
- package/dist/core/plan/plan-stamp.d.ts +75 -0
- package/dist/core/runtime/identity.d.ts +21 -0
- package/dist/core/runtime/index.d.ts +46 -0
- package/dist/effort/store/bring-forward.d.ts +131 -0
- package/dist/effort/store/check-rows.d.ts +31 -0
- package/dist/effort/store/commit-stats.d.ts +42 -0
- package/dist/effort/store/copy.d.ts +35 -0
- package/dist/effort/store/development-build.d.ts +105 -0
- package/dist/effort/store/effort-levels.d.ts +13 -0
- package/dist/effort/store/findings.d.ts +214 -0
- package/dist/effort/store/fix-schema.d.ts +184 -0
- package/dist/effort/store/index.js +10 -7
- package/dist/effort/store/location.d.ts +44 -0
- package/dist/effort/store/merge-commit-gaps.d.ts +68 -0
- package/dist/effort/store/merge-conflicts.d.ts +91 -0
- package/dist/effort/store/merge-rules.d.ts +82 -0
- package/dist/effort/store/merge-store.d.ts +211 -0
- package/dist/effort/store/merge-union.d.ts +92 -0
- package/dist/effort/store/migrate.d.ts +146 -0
- package/dist/effort/store/migrations.d.ts +92 -0
- package/dist/effort/store/ndjson-files.d.ts +114 -0
- package/dist/effort/store/origins.d.ts +116 -0
- package/dist/effort/store/plan-stubs.d.ts +79 -0
- package/dist/effort/store/rebuild-aside.d.ts +172 -0
- package/dist/effort/store/schema-plan.d.ts +102 -0
- package/dist/effort/store/session-row-types.d.ts +64 -0
- package/dist/effort/store/settings.d.ts +13 -0
- package/dist/effort/store/sqlite.d.ts +340 -0
- package/dist/effort/store/store-generation.d.ts +17 -0
- package/dist/effort/store/store-identity.d.ts +220 -0
- package/dist/effort/store/store-meta.d.ts +305 -0
- package/dist/effort/store/store-replaced.d.ts +72 -0
- package/dist/effort/store/types.d.ts +223 -0
- package/dist/errors/codes.d.ts +56 -0
- package/dist/errors/rafa-codes.d.ts +36 -0
- package/dist/{index-nv34ptht.js → index-38ktnyvz.js} +14 -9
- package/dist/index-3mwsr6wg.js +1070 -0
- package/dist/index-7dgc5g1t.js +13480 -0
- package/dist/index-cbqvgda6.js +766 -0
- package/dist/index-eay1bd2w.js +2632 -0
- package/dist/index-f1y86zbb.js +125 -0
- package/dist/index-n3e31fmw.js +1041 -0
- package/dist/{index-r28fzsvc.js → index-nwzx41g1.js} +351 -166
- package/dist/index-pzpb1rf7.js +153 -0
- package/dist/{index-mgh2s9bj.js → index-r5q2pdky.js} +65 -457
- package/dist/index-z1w83f81.js +4 -0
- package/dist/index.js +17592 -24119
- package/dist/learning/index.js +5 -6
- package/dist/plan/index.js +12 -11
- package/dist/plan-prompt.md +3 -1
- package/dist/ports/index.d.ts +732 -0
- package/dist/ports/learning.d.ts +101 -0
- package/dist/ports/log-level.d.ts +13 -0
- package/dist/ports/spec-review.d.ts +66 -0
- package/dist/ready-6p40c3gw.js +2007 -0
- package/dist/release-templates/release-bot-fragment.yml +153 -0
- package/dist/release-templates/release-publish.yml +110 -0
- package/dist/release-templates/release-settle.yml +122 -0
- package/dist/release-templates/release-tag.yml +102 -0
- package/dist/report/parse.d.ts +415 -0
- package/dist/schema/project-id.d.ts +79 -0
- package/dist/schema/tiers.d.ts +107 -0
- package/package.json +62 -3
- package/dist/index-hf2k497d.js +0 -16
- package/dist/index-nsr78ct2.js +0 -8219
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The records the Learning port passes, and the answers it gives: core's
|
|
3
|
+
* declaration of the six types `packages/rafa/src/ports/index.ts` names for it.
|
|
4
|
+
*
|
|
5
|
+
* The learning library declares the same six in `src/learning/types.ts`
|
|
6
|
+
* and keeps them there. `src/learning/` imports nothing from the rest of
|
|
7
|
+
* `src/`, and core imports nothing above it, so neither side can take
|
|
8
|
+
* the other's declaration: each declares its own, and
|
|
9
|
+
* `src/tests/learning-contract.test.ts` holds every pair mutually
|
|
10
|
+
* assignable, so a field added, dropped or retyped on one side alone
|
|
11
|
+
* fails to compile there.
|
|
12
|
+
*
|
|
13
|
+
* Types only, as `index.ts` and `log-level.ts` beside it are: the module
|
|
14
|
+
* holds no runtime value, so importing it runs nothing. The fields are
|
|
15
|
+
* snake case, as the distributed-learning spec spells the record a sync
|
|
16
|
+
* payload carries.
|
|
17
|
+
*/
|
|
18
|
+
/**
|
|
19
|
+
* One instinct: a trigger, the action to take on it, and how far to
|
|
20
|
+
* trust that action.
|
|
21
|
+
*/
|
|
22
|
+
export interface InstinctRecord {
|
|
23
|
+
id: string;
|
|
24
|
+
trigger: string;
|
|
25
|
+
action: string;
|
|
26
|
+
/** `sha256(trim(lower(action)))`: two records share an action by it. */
|
|
27
|
+
action_hash: string;
|
|
28
|
+
/** From 0.3 to 0.9. */
|
|
29
|
+
confidence: number;
|
|
30
|
+
/**
|
|
31
|
+
* The weight a merge gives the confidence. Once a record carries
|
|
32
|
+
* {@link InstinctRecord.sources}, it equals that list's length.
|
|
33
|
+
*/
|
|
34
|
+
usage_count: number;
|
|
35
|
+
/**
|
|
36
|
+
* The distinct `source_id`s that confirmed the record. A merge takes
|
|
37
|
+
* the union, which is what makes a source pushing one record twice
|
|
38
|
+
* count once. Left out by a record written before sources were kept.
|
|
39
|
+
*/
|
|
40
|
+
sources?: string[];
|
|
41
|
+
/** The recurrence key; phase 2's field. */
|
|
42
|
+
artifact?: string;
|
|
43
|
+
signal: 'loud' | 'silent';
|
|
44
|
+
/** A `flagged` record is excluded from every blessed bundle. */
|
|
45
|
+
status: 'active' | 'flagged';
|
|
46
|
+
/**
|
|
47
|
+
* The path of the page the wrap-up wrote the record into. A promoted
|
|
48
|
+
* record leaves every blessed bundle, because the page now carries it.
|
|
49
|
+
*/
|
|
50
|
+
promoted_to?: string;
|
|
51
|
+
created_at: string;
|
|
52
|
+
updated_at: string;
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* What one source pushes. Under the `local` adapter the source is the
|
|
56
|
+
* task's session id, so two tasks of one plan are two sources.
|
|
57
|
+
*/
|
|
58
|
+
export interface SyncPayload {
|
|
59
|
+
source_id: string;
|
|
60
|
+
instincts: InstinctRecord[];
|
|
61
|
+
}
|
|
62
|
+
/** What a pull answers: the instincts blessed for injection. */
|
|
63
|
+
export interface BlessedBundle {
|
|
64
|
+
version: string;
|
|
65
|
+
instincts: InstinctRecord[];
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* The rule a merge applied to one incoming record, one per row of the
|
|
69
|
+
* spec's merge table plus the record whose trigger nothing shares:
|
|
70
|
+
*
|
|
71
|
+
* - `new-trigger`: no held record shares the trigger, so it is kept.
|
|
72
|
+
* - `same-action`: the same `action_hash`, so the confidences are
|
|
73
|
+
* weighted by usage and the sources joined.
|
|
74
|
+
* - `higher-confidence`: a different action, confidences more than
|
|
75
|
+
* 0.10 apart, so the higher one wins.
|
|
76
|
+
* - `flagged`: a different action, confidences within 0.10, so both
|
|
77
|
+
* are kept and flagged.
|
|
78
|
+
*/
|
|
79
|
+
export type MergeRule = 'new-trigger' | 'same-action' | 'higher-confidence' | 'flagged';
|
|
80
|
+
/** Which rule applied to one incoming record, and what it produced. */
|
|
81
|
+
export interface MergeDecision {
|
|
82
|
+
incoming: InstinctRecord;
|
|
83
|
+
rule: MergeRule;
|
|
84
|
+
/** The records the trigger is held as once the rule has applied. */
|
|
85
|
+
produced: InstinctRecord[];
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* What a merge did, so a consumer can log each decision.
|
|
89
|
+
*
|
|
90
|
+
* The spec names `discarded` and describes the rest, a list saying which
|
|
91
|
+
* rule applied to each incoming record and what it produced, without
|
|
92
|
+
* naming it; `decisions`, {@link MergeDecision} and the
|
|
93
|
+
* {@link MergeRule} names are the learning library's, and this module
|
|
94
|
+
* spells them as the library does.
|
|
95
|
+
*/
|
|
96
|
+
export interface MergeResult {
|
|
97
|
+
/** One per incoming record, in the payload's order. */
|
|
98
|
+
decisions: MergeDecision[];
|
|
99
|
+
/** The records a higher-confidence action displaced; none is deleted. */
|
|
100
|
+
discarded: InstinctRecord[];
|
|
101
|
+
}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The logger's level, in a leaf of its own so a module that needs only
|
|
3
|
+
* the level (the logger's settings, the config section that reads them)
|
|
4
|
+
* imports it without reaching the rest of `./ports`. `packages/rafa/src/ports/index.ts`
|
|
5
|
+
* re-exports it, so the `./ports` subpath names it unchanged.
|
|
6
|
+
*/
|
|
7
|
+
/**
|
|
8
|
+
* How loud a log entry is, or `api` for the metadata of one request and
|
|
9
|
+
* its response. `error`, `warn` and `debug` are ordered, quietest first;
|
|
10
|
+
* `api` sits outside that order and is turned on by itself. There is no
|
|
11
|
+
* `info`: that is a command's own text, which goes through `Output`.
|
|
12
|
+
*/
|
|
13
|
+
export type LogLevel = 'error' | 'warn' | 'debug' | 'api';
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The shapes a spec review is read into: the verdicts and readings a
|
|
3
|
+
* `rafa:spec-review` block answers, the gaps it names and the issues it
|
|
4
|
+
* reports. Core's `Planner` port names {@link SpecReviewReading}, so they
|
|
5
|
+
* sit here, below the board; `src/board/spec-review.ts` reads the block
|
|
6
|
+
* into them, re-exports them under the same names, and keeps the parser,
|
|
7
|
+
* the headings and the two fallback gaps.
|
|
8
|
+
*/
|
|
9
|
+
import type { RafaBlock } from '../core/plan/block-reader.js';
|
|
10
|
+
/** The two words the block's `verdict` is spelled with. */
|
|
11
|
+
export declare const SPEC_REVIEW_VERDICTS: readonly ["ready", "not-ready"];
|
|
12
|
+
/** One of the two verdicts a session can write. */
|
|
13
|
+
export type SpecReviewVerdict = (typeof SPEC_REVIEW_VERDICTS)[number];
|
|
14
|
+
/**
|
|
15
|
+
* The four readings a session output answers. The first two are the
|
|
16
|
+
* verdicts as written; the last two are a block that could not be read,
|
|
17
|
+
* and are not-ready all the same.
|
|
18
|
+
*/
|
|
19
|
+
export declare const SPEC_REVIEW_ANSWERS: readonly ["ready", "not-ready", "absent", "malformed"];
|
|
20
|
+
/** One of the four readings; see {@link SPEC_REVIEW_ANSWERS}. */
|
|
21
|
+
export type SpecReviewAnswer = (typeof SPEC_REVIEW_ANSWERS)[number];
|
|
22
|
+
/** One thing the planner found keeping a spec from being planned from. */
|
|
23
|
+
export interface SpecReviewGap {
|
|
24
|
+
/** The spec heading it sits under, as the comment names it. */
|
|
25
|
+
readonly heading: string;
|
|
26
|
+
/** What is wrong under that heading, as the session wrote it. */
|
|
27
|
+
readonly what: string;
|
|
28
|
+
/**
|
|
29
|
+
* True when guessing wrong here changes what ships or what is safe,
|
|
30
|
+
* so nothing can be planned until the spec answers it. True for
|
|
31
|
+
* every gap whose `blocking` was unreadable and for every
|
|
32
|
+
* non-blocking one that named no assumption; see the module note.
|
|
33
|
+
*/
|
|
34
|
+
readonly blocking: boolean;
|
|
35
|
+
/**
|
|
36
|
+
* What the planner would plan under, as the session wrote it. Never
|
|
37
|
+
* null for a gap that is not blocking; null for a blocking gap that
|
|
38
|
+
* named none.
|
|
39
|
+
*/
|
|
40
|
+
readonly assumption: string | null;
|
|
41
|
+
}
|
|
42
|
+
/** One thing the block said that this reading does not hold as written. */
|
|
43
|
+
export interface SpecReviewIssue {
|
|
44
|
+
/** Where, in the block's own key names: `gaps[2].what`. */
|
|
45
|
+
readonly field: string;
|
|
46
|
+
/** One sentence for an operator to read. */
|
|
47
|
+
readonly text: string;
|
|
48
|
+
}
|
|
49
|
+
/** A session output, read for its `rafa:spec-review` block. */
|
|
50
|
+
export interface SpecReviewReading {
|
|
51
|
+
/** Which of the four readings this is. */
|
|
52
|
+
readonly answer: SpecReviewAnswer;
|
|
53
|
+
/** True for `ready` alone; what the gate acts on. */
|
|
54
|
+
readonly ready: boolean;
|
|
55
|
+
/**
|
|
56
|
+
* Every gap to post. Empty only for a ready reading; see the module
|
|
57
|
+
* note for what fills it when the session named none.
|
|
58
|
+
*/
|
|
59
|
+
readonly gaps: readonly SpecReviewGap[];
|
|
60
|
+
/** The last `rafa:spec-review` block, or null when there is none. */
|
|
61
|
+
readonly block: RafaBlock | null;
|
|
62
|
+
/** One sentence for an operator to read. */
|
|
63
|
+
readonly text: string;
|
|
64
|
+
/** What was not read as written. Empty for a clean block. */
|
|
65
|
+
readonly issues: readonly SpecReviewIssue[];
|
|
66
|
+
}
|