@difflab/difflab-cli 0.13.0 → 0.13.1
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/dist/index.js +132 -106
- package/package.json +2 -2
package/dist/index.js
CHANGED
|
@@ -12497,7 +12497,7 @@ var init_migration = __esm(() => {
|
|
|
12497
12497
|
init_migrator();
|
|
12498
12498
|
});
|
|
12499
12499
|
|
|
12500
|
-
// ../../libs/difflab-db/src/migrations.ts
|
|
12500
|
+
// ../../libs/difflab-db-legacy/src/migrations.ts
|
|
12501
12501
|
async function migrate(db) {
|
|
12502
12502
|
const { error } = await new Migrator({ db, provider }).migrateToLatest();
|
|
12503
12503
|
if (error)
|
|
@@ -12696,7 +12696,7 @@ var init_normal = __esm(() => {
|
|
|
12696
12696
|
};
|
|
12697
12697
|
});
|
|
12698
12698
|
|
|
12699
|
-
// ../../libs/difflab-db/src/retry.ts
|
|
12699
|
+
// ../../libs/difflab-db-legacy/src/retry.ts
|
|
12700
12700
|
async function retryDatabaseOperation(work, retryable = isSqliteContention) {
|
|
12701
12701
|
for (let attempt = 1;; attempt++) {
|
|
12702
12702
|
try {
|
|
@@ -12726,7 +12726,7 @@ function errorChain(error) {
|
|
|
12726
12726
|
}
|
|
12727
12727
|
var maxAttempts = 10;
|
|
12728
12728
|
|
|
12729
|
-
// ../../libs/difflab-db/src/registry.ts
|
|
12729
|
+
// ../../libs/difflab-db-legacy/src/registry.ts
|
|
12730
12730
|
import { lstat } from "fs/promises";
|
|
12731
12731
|
import { resolve } from "path";
|
|
12732
12732
|
async function withDatabaseAccess(path, work) {
|
|
@@ -19227,7 +19227,7 @@ var init_zod = __esm(() => {
|
|
|
19227
19227
|
init_external();
|
|
19228
19228
|
});
|
|
19229
19229
|
|
|
19230
|
-
// ../../libs/difflab-db/src/entities/repository.ts
|
|
19230
|
+
// ../../libs/difflab-db-legacy/src/entities/repository.ts
|
|
19231
19231
|
var repositorySchema, validateRepository = (value) => repositorySchema.parse(value);
|
|
19232
19232
|
var init_repository = __esm(() => {
|
|
19233
19233
|
init_zod();
|
|
@@ -19239,7 +19239,7 @@ var init_repository = __esm(() => {
|
|
|
19239
19239
|
});
|
|
19240
19240
|
});
|
|
19241
19241
|
|
|
19242
|
-
// ../../libs/difflab-db/src/entities/project.ts
|
|
19242
|
+
// ../../libs/difflab-db-legacy/src/entities/project.ts
|
|
19243
19243
|
var projectSchema, validateProject = (value) => projectSchema.parse(value);
|
|
19244
19244
|
var init_project = __esm(() => {
|
|
19245
19245
|
init_zod();
|
|
@@ -19251,7 +19251,7 @@ var init_project = __esm(() => {
|
|
|
19251
19251
|
});
|
|
19252
19252
|
});
|
|
19253
19253
|
|
|
19254
|
-
// ../../libs/difflab-db/src/queries/projects.ts
|
|
19254
|
+
// ../../libs/difflab-db-legacy/src/queries/projects.ts
|
|
19255
19255
|
import { randomUUID } from "crypto";
|
|
19256
19256
|
function validateProjectKey(key) {
|
|
19257
19257
|
const normalized = key.trim().toUpperCase();
|
|
@@ -19355,7 +19355,7 @@ var init_projects = __esm(() => {
|
|
|
19355
19355
|
};
|
|
19356
19356
|
});
|
|
19357
19357
|
|
|
19358
|
-
// ../../libs/difflab-db/src/queries/repositories.ts
|
|
19358
|
+
// ../../libs/difflab-db-legacy/src/queries/repositories.ts
|
|
19359
19359
|
import { randomUUID as randomUUID2 } from "crypto";
|
|
19360
19360
|
function createRepositoryQueries(db, readonly, dbPath) {
|
|
19361
19361
|
return {
|
|
@@ -19412,7 +19412,7 @@ var init_repositories = __esm(() => {
|
|
|
19412
19412
|
init_projects();
|
|
19413
19413
|
});
|
|
19414
19414
|
|
|
19415
|
-
// ../../libs/difflab-db/src/index.ts
|
|
19415
|
+
// ../../libs/difflab-db-legacy/src/index.ts
|
|
19416
19416
|
async function createDifflabDb(dbPath, options = {}) {
|
|
19417
19417
|
const readonly = options.readonly ?? false;
|
|
19418
19418
|
const db = await openDatabase(dbPath, readonly);
|
|
@@ -48351,44 +48351,47 @@ var spec_driven_plan_default = `# [Outcome to deliver]
|
|
|
48351
48351
|
|
|
48352
48352
|
## Intent
|
|
48353
48353
|
|
|
48354
|
-
[
|
|
48354
|
+
[State who needs this change, what becomes possible afterward, and why it matters now.]
|
|
48355
48355
|
|
|
48356
48356
|
## Requirements
|
|
48357
48357
|
|
|
48358
|
-
-
|
|
48359
|
-
|
|
48358
|
+
[List observable behavioral capabilities and performance, security, cost, isolation, and reliability characteristics from a client, caller, or end-user perspective. Use plain bullets without \`FR\` or \`NFR\` prefixes. Put internal types, function names, CLI flags, configuration internals, file layouts, and code-style rules in Design and Phases.]
|
|
48359
|
+
|
|
48360
|
+
- [Observable client or end-user behavior and how to make sure that it works.]
|
|
48361
|
+
- [Observable performance, security, cost, isolation, or reliability characteristic.]
|
|
48362
|
+
- [Explicit boundaries and non-goals.]
|
|
48360
48363
|
|
|
48361
48364
|
## Design
|
|
48362
48365
|
|
|
48363
48366
|
### Big Ideas
|
|
48364
48367
|
|
|
48365
|
-
[Lead with compact diagrams.
|
|
48368
|
+
[Lead with compact Mermaid diagrams or fenced trees. Drop prose when a diagram shows the structure or flow. Show component relationships with a component diagram, processes with a flowchart, and file artifacts with a tree. Keep decisions, responsibilities, invariants, and failure behavior beside the visual. Draw only affected parts, and include enough detail to execute without the original chat.]
|
|
48366
48369
|
|
|
48367
48370
|
### Infrastructure Changes
|
|
48368
48371
|
|
|
48369
|
-
[
|
|
48372
|
+
[List hosting, service, deployment, network, or managed-resource changes. Put new source modules in Repo Changes. If no infrastructure changes, write N/A.]
|
|
48370
48373
|
|
|
48371
48374
|
### Interfaces
|
|
48372
48375
|
|
|
48373
|
-
[
|
|
48376
|
+
[Show changed public interactions, contracts, and failure results with compact commands, signatures, code, or pseudocode. Keep implementation steps in Phases.]
|
|
48374
48377
|
|
|
48375
48378
|
### Consequences
|
|
48376
48379
|
|
|
48377
48380
|
#### Repo Changes
|
|
48378
48381
|
|
|
48379
|
-
[
|
|
48382
|
+
[Draw a directory-grouped file tree with \`[M]\` modified, \`[A]\` added, \`[D]\` deleted, and \`[R]\` renamed markers. Apply \`/difflab-writing-style\`. Use real paths for existing files, label new files, and note the largest edits. If no files are removed, state that explicitly.]
|
|
48380
48383
|
|
|
48381
48384
|
#### Testing
|
|
48382
48385
|
|
|
48383
|
-
[Apply \`/difflab-bdd\`.
|
|
48386
|
+
[Apply \`/difflab-bdd\`. Draw a Mermaid behavior flowchart from the user or caller perspective with context branches, state transitions, and converging states. Map the flowchart to a nested \`[M/A/D/R]\` BDD test tree starting at \`given <context>\` with \`when\` and \`then\` clauses. Collapse single-outcome branches to \`when <action>, then <outcome>\`, and hoist shared fixtures. Prioritize \`e2e\` over \`integration\` over \`unit\`, and name human-verifiable outputs such as screenshots, snapshots, JSON payloads, or logs. If a skill change has no test harness, label its validation steps \`manual acceptance\`.]
|
|
48384
48387
|
|
|
48385
48388
|
#### Trade-offs
|
|
48386
48389
|
|
|
48387
|
-
[
|
|
48390
|
+
[State risks, compatibility limits, and deferred work.]
|
|
48388
48391
|
|
|
48389
48392
|
## Phases
|
|
48390
48393
|
|
|
48391
|
-
[
|
|
48394
|
+
[List ordered tasks with file or module targets. Keep design decisions in Design. Name application behavior for end-to-end tests and public module behavior for integration tests. Use separate Arrange, Act, and Assert steps. Follow the execution workflow permissions for commits and pushes.]
|
|
48392
48395
|
|
|
48393
48396
|
### Phase 1: [Outcome]
|
|
48394
48397
|
|
|
@@ -48397,9 +48400,9 @@ var spec_driven_plan_default = `# [Outcome to deliver]
|
|
|
48397
48400
|
- [ ] [Task C]
|
|
48398
48401
|
- [ ] [Task D]
|
|
48399
48402
|
- [ ] Validation
|
|
48400
|
-
- [ ] [
|
|
48401
|
-
- [ ] [
|
|
48402
|
-
- [ ] [
|
|
48403
|
+
- [ ] [Make sure that the observable application or module contract passes its test.]
|
|
48404
|
+
- [ ] [Run format, lint, and build tasks.]
|
|
48405
|
+
- [ ] [If execution authorizes commits and expects CI, commit changes and make sure that CI passes.]
|
|
48403
48406
|
|
|
48404
48407
|
### Phase 2: [Outcome]
|
|
48405
48408
|
|
|
@@ -48408,9 +48411,9 @@ var spec_driven_plan_default = `# [Outcome to deliver]
|
|
|
48408
48411
|
- [ ] [Task C]
|
|
48409
48412
|
- [ ] [Task D]
|
|
48410
48413
|
- [ ] Validation
|
|
48411
|
-
- [ ] [
|
|
48412
|
-
- [ ] [
|
|
48413
|
-
- [ ] [
|
|
48414
|
+
- [ ] [Make sure that the observable application or module contract passes its test.]
|
|
48415
|
+
- [ ] [Run format, lint, and build tasks.]
|
|
48416
|
+
- [ ] [If execution authorizes commits and expects CI, commit changes and make sure that CI passes.]
|
|
48414
48417
|
|
|
48415
48418
|
### Phase 3: [Outcome]
|
|
48416
48419
|
|
|
@@ -48419,46 +48422,48 @@ var spec_driven_plan_default = `# [Outcome to deliver]
|
|
|
48419
48422
|
- [ ] [Task C]
|
|
48420
48423
|
- [ ] [Task D]
|
|
48421
48424
|
- [ ] Validation
|
|
48422
|
-
- [ ] [
|
|
48423
|
-
- [ ] [
|
|
48424
|
-
- [ ] [
|
|
48425
|
+
- [ ] [Make sure that the observable application or module contract passes its test.]
|
|
48426
|
+
- [ ] [Run format, lint, and build tasks.]
|
|
48427
|
+
- [ ] [If execution authorizes commits and expects CI, commit changes and make sure that CI passes.]
|
|
48425
48428
|
|
|
48426
48429
|
## References
|
|
48427
48430
|
|
|
48428
|
-
- [Source or
|
|
48429
|
-
- [
|
|
48431
|
+
- [Source issue or architecture decision.]
|
|
48432
|
+
- [Supporting external specification or documentation.]
|
|
48433
|
+
- [Related repository path or prior plan.]
|
|
48430
48434
|
`;
|
|
48431
48435
|
var init_spec_driven_plan = () => {};
|
|
48432
48436
|
|
|
48433
48437
|
// templates/software-architecture-design.md
|
|
48434
|
-
var software_architecture_design_default = `# [System or feature]
|
|
48438
|
+
var software_architecture_design_default = `# [System or feature]: software architecture
|
|
48435
48439
|
|
|
48436
48440
|
## Overview
|
|
48437
48441
|
|
|
48438
|
-
[
|
|
48442
|
+
[State the purpose, system boundary, users, and explicit non-goals.]
|
|
48439
48443
|
|
|
48440
48444
|
## Requirement
|
|
48441
48445
|
|
|
48442
48446
|
### Functional
|
|
48443
48447
|
|
|
48444
|
-
[
|
|
48448
|
+
[List observable behavioral capabilities from a client, caller, or end-user perspective. Use plain bullets without \`FR\` prefixes. Put internal types, function names, configuration internals, file layouts, and code-style rules in Design and Implementation.]
|
|
48445
48449
|
|
|
48446
|
-
-
|
|
48447
|
-
-
|
|
48448
|
-
-
|
|
48450
|
+
- [Client or end-user capability and observable outcome.]
|
|
48451
|
+
- [Additional client or end-user capability and observable outcome.]
|
|
48452
|
+
- [Explicit behavioral boundary or rejection rule.]
|
|
48449
48453
|
|
|
48450
48454
|
### Non-Functional
|
|
48451
48455
|
|
|
48452
|
-
[
|
|
48456
|
+
[List performance, security, cost, isolation, and reliability characteristics from a client, caller, or end-user perspective. Use plain bullets without \`NFR\` prefixes. Put internal mechanisms in Design and Implementation.]
|
|
48453
48457
|
|
|
48454
|
-
-
|
|
48455
|
-
-
|
|
48458
|
+
- [Observable performance, reliability, or cost bound.]
|
|
48459
|
+
- [Observable security or isolation guarantee.]
|
|
48460
|
+
- [Additional external operational characteristic.]
|
|
48456
48461
|
|
|
48457
48462
|
## Design
|
|
48458
48463
|
|
|
48459
48464
|
### Components and Responsibilities
|
|
48460
48465
|
|
|
48461
|
-
[
|
|
48466
|
+
[Draw a system diagram and list each component with its responsibility and relationships. Use Mermaid diagrams unless \`AGENTS.md\` states another format.]
|
|
48462
48467
|
|
|
48463
48468
|
> @agent: add example mermaid diagram
|
|
48464
48469
|
|
|
@@ -48466,31 +48471,33 @@ var software_architecture_design_default = `# [System or feature] \u2014 softwar
|
|
|
48466
48471
|
|
|
48467
48472
|
\`\`\`
|
|
48468
48473
|
|
|
48469
|
-
- Component A
|
|
48470
|
-
-
|
|
48471
|
-
-
|
|
48474
|
+
- [Component A handles this responsibility.]
|
|
48475
|
+
- [Component A calls Component B for that responsibility.]
|
|
48476
|
+
- [Component C stores this state.]
|
|
48472
48477
|
|
|
48473
48478
|
### Data and Control Flow
|
|
48474
48479
|
|
|
48475
|
-
[
|
|
48480
|
+
[Trace the main request or event path and name where state lives. If a flowchart or sequence diagram clarifies the path, include it.]
|
|
48476
48481
|
|
|
48477
48482
|
### Interfaces and Contracts
|
|
48478
48483
|
|
|
48479
|
-
[
|
|
48484
|
+
[List database entities, input and output schemas, endpoints, core types, and public methods. If data models change, include an entity-relationship diagram.]
|
|
48480
48485
|
|
|
48481
48486
|
## Implementation
|
|
48482
48487
|
|
|
48483
48488
|
### Important topic 1
|
|
48484
48489
|
|
|
48485
|
-
[
|
|
48490
|
+
[List owned modules, dependency direction, and extension points.]
|
|
48486
48491
|
|
|
48487
48492
|
### Important topic 2
|
|
48488
48493
|
|
|
48489
|
-
[
|
|
48494
|
+
[List operational rules, configuration internals, or code-level invariants.]
|
|
48490
48495
|
|
|
48491
48496
|
## References
|
|
48492
48497
|
|
|
48493
48498
|
- [Relevant code, ADR, or external specification.]
|
|
48499
|
+
- [Related design document or issue.]
|
|
48500
|
+
- [Applicable external standard or API contract.]
|
|
48494
48501
|
`;
|
|
48495
48502
|
var init_software_architecture_design = () => {};
|
|
48496
48503
|
|
|
@@ -48562,59 +48569,69 @@ var init_architecture_decision_record = () => {};
|
|
|
48562
48569
|
// templates/product-requirements-document.md
|
|
48563
48570
|
var product_requirements_document_default = `# [User outcome or product change]
|
|
48564
48571
|
|
|
48565
|
-
> @agent: make this closer to the PRD under prd dir!
|
|
48566
|
-
|
|
48567
48572
|
- **Status:** draft
|
|
48568
48573
|
- **Owner:** [person or team]
|
|
48569
48574
|
- **Date:** [YYYY-MM-DD]
|
|
48570
48575
|
|
|
48571
48576
|
## Summary
|
|
48572
48577
|
|
|
48573
|
-
[
|
|
48578
|
+
[State what changes for users and why it matters.]
|
|
48574
48579
|
|
|
48575
48580
|
## Problem and Evidence
|
|
48576
48581
|
|
|
48577
|
-
[
|
|
48582
|
+
[Name who has the problem and state observed evidence or explicit assumptions.]
|
|
48578
48583
|
|
|
48579
48584
|
## Users and Use Cases
|
|
48580
48585
|
|
|
48581
|
-
- [
|
|
48586
|
+
- [Primary user]: [Job to be done and context.]
|
|
48587
|
+
- [Secondary user]: [Job to be done and context.]
|
|
48588
|
+
- [Operator or caller]: [Job to be done and context.]
|
|
48582
48589
|
|
|
48583
48590
|
## Goals
|
|
48584
48591
|
|
|
48585
|
-
- [
|
|
48592
|
+
- [Primary user outcome to achieve.]
|
|
48593
|
+
- [Secondary user outcome to achieve.]
|
|
48594
|
+
- [Operational or quality outcome to achieve.]
|
|
48586
48595
|
|
|
48587
48596
|
## Non-Goals
|
|
48588
48597
|
|
|
48589
|
-
- [Related need that this work
|
|
48598
|
+
- [Related need that this work excludes.]
|
|
48599
|
+
- [Out-of-scope workflow or integration.]
|
|
48600
|
+
- [Deferred capability for a later release.]
|
|
48590
48601
|
|
|
48591
48602
|
## Proposed Experience
|
|
48592
48603
|
|
|
48593
|
-
[Describe the user journey, inputs, outputs,
|
|
48604
|
+
[Describe the user journey, inputs, outputs, error messages, and recovery path.]
|
|
48594
48605
|
|
|
48595
48606
|
## Requirements
|
|
48596
48607
|
|
|
48597
|
-
|
|
48608
|
+
[Describe observable behavioral capabilities and performance, security, cost, isolation, and reliability characteristics from an end-user or client perspective. Do not use \`FR\` or \`NFR\` prefixes. Leave internal types, function names, configuration internals, file layouts, and code-style rules out of this section.]
|
|
48598
48609
|
|
|
48599
|
-
[
|
|
48610
|
+
### [Capability or quality characteristic]
|
|
48600
48611
|
|
|
48601
|
-
|
|
48612
|
+
[State required user-facing behavior, edge cases, and operational bounds.]
|
|
48613
|
+
|
|
48614
|
+
Acceptance: [State an observable way to make sure that the requirement works.]
|
|
48602
48615
|
|
|
48603
48616
|
## Success Measures
|
|
48604
48617
|
|
|
48605
|
-
[
|
|
48618
|
+
[State the signal, baseline or assumption, target, and measurement method.]
|
|
48606
48619
|
|
|
48607
48620
|
## Risks and Dependencies
|
|
48608
48621
|
|
|
48609
|
-
- [
|
|
48622
|
+
- [Technical or product risk]: [Mitigation or owner.]
|
|
48623
|
+
- [External dependency]: [Mitigation or owner.]
|
|
48624
|
+
- [Operational or rollout risk]: [Mitigation or owner.]
|
|
48610
48625
|
|
|
48611
48626
|
## Open Questions
|
|
48612
48627
|
|
|
48613
|
-
- [
|
|
48628
|
+
- [Product decision and owner.]
|
|
48629
|
+
- [Scope question and owner.]
|
|
48630
|
+
- [Rollout question and owner.]
|
|
48614
48631
|
|
|
48615
48632
|
## Rollout
|
|
48616
48633
|
|
|
48617
|
-
[
|
|
48634
|
+
[Describe the release plan, feedback loop, migration path, and rollback steps.]
|
|
48618
48635
|
`;
|
|
48619
48636
|
var init_product_requirements_document = () => {};
|
|
48620
48637
|
|
|
@@ -48762,12 +48779,12 @@ sections:
|
|
|
48762
48779
|
scope: file
|
|
48763
48780
|
default_severity: consider
|
|
48764
48781
|
issue: >-
|
|
48765
|
-
Function or
|
|
48782
|
+
Function or symbol names misrepresent behavior, hide side effects, or break written naming rules.
|
|
48766
48783
|
results: []
|
|
48767
48784
|
- id: readability.structure
|
|
48768
48785
|
scope: file
|
|
48769
48786
|
default_severity: consider
|
|
48770
|
-
issue: The changed flow is
|
|
48787
|
+
issue: The changed control flow is hard to follow.
|
|
48771
48788
|
results: []
|
|
48772
48789
|
- title: Semantic Organization
|
|
48773
48790
|
criteria:
|
|
@@ -48779,25 +48796,25 @@ sections:
|
|
|
48779
48796
|
- id: organization.architecture
|
|
48780
48797
|
scope: review
|
|
48781
48798
|
default_severity: consider
|
|
48782
|
-
issue: Files or classes mix responsibilities, obscure ownership, or
|
|
48799
|
+
issue: Files or classes mix responsibilities, obscure ownership, or break written architecture rules.
|
|
48783
48800
|
results: []
|
|
48784
48801
|
- id: organization.api-ergonomics
|
|
48785
48802
|
scope: applicable-file
|
|
48786
48803
|
applies_when: Added or modified public APIs, exported types, methods, or classes.
|
|
48787
48804
|
default_severity: consider
|
|
48788
|
-
issue: Public APIs expose types unrelated to the module role or
|
|
48805
|
+
issue: Public APIs expose types unrelated to the module role or remain hard to discover and use.
|
|
48789
48806
|
results: []
|
|
48790
48807
|
- id: organization.new-files
|
|
48791
48808
|
scope: applicable-file
|
|
48792
48809
|
applies_when: Added source files that introduce a module or submodule. A rename alone does not qualify.
|
|
48793
48810
|
default_severity: consider
|
|
48794
48811
|
issue: >-
|
|
48795
|
-
A new file lacks a
|
|
48812
|
+
A new file lacks a clear module boundary or contains functions that belong in an existing module.
|
|
48796
48813
|
results: []
|
|
48797
48814
|
- id: organization.file-structure
|
|
48798
48815
|
scope: file
|
|
48799
48816
|
default_severity: consider
|
|
48800
|
-
issue: A file breaks the
|
|
48817
|
+
issue: A file breaks the prescribed section order or declaration layout.
|
|
48801
48818
|
results: []
|
|
48802
48819
|
- title: Maintainability
|
|
48803
48820
|
criteria:
|
|
@@ -48805,93 +48822,101 @@ sections:
|
|
|
48805
48822
|
scope: review
|
|
48806
48823
|
default_severity: consider
|
|
48807
48824
|
issue: >-
|
|
48808
|
-
New fields, types, wrappers, helpers, dependencies, or layers lack a
|
|
48825
|
+
New fields, types, wrappers, helpers, dependencies, or layers lack a clear caller need and add complexity.
|
|
48809
48826
|
results: []
|
|
48810
48827
|
- id: maintainability.complexity
|
|
48811
48828
|
scope: applicable-file
|
|
48812
48829
|
applies_when: >-
|
|
48813
|
-
Files with added or changed executable functions. For new functions,
|
|
48830
|
+
Files with added or changed executable functions. For new functions, evaluate whether required behavior needs the introduced branches.
|
|
48814
48831
|
default_severity: consider
|
|
48815
|
-
issue: Cyclomatic complexity grows
|
|
48832
|
+
issue: Cyclomatic complexity grows beyond what the required behavior needs.
|
|
48816
48833
|
results: []
|
|
48817
48834
|
- id: maintainability.utilities
|
|
48818
48835
|
scope: review
|
|
48819
48836
|
default_severity: consider
|
|
48820
|
-
issue: Duplicated state
|
|
48837
|
+
issue: Duplicated state, repeated logic, or inline work makes a function hard to read or maintain.
|
|
48821
48838
|
results: []
|
|
48822
48839
|
- id: maintainability.packages
|
|
48823
48840
|
scope: review
|
|
48824
48841
|
default_severity: consider
|
|
48825
48842
|
issue: >-
|
|
48826
|
-
Custom code recreates functionality that an established
|
|
48843
|
+
Custom code recreates functionality that an established package already provides.
|
|
48827
48844
|
results: []
|
|
48828
48845
|
- title: Reliability/Testing
|
|
48829
48846
|
criteria:
|
|
48830
48847
|
- id: testing.correctness
|
|
48831
48848
|
scope: file
|
|
48832
48849
|
default_severity: blocking
|
|
48833
|
-
issue: The changed code produces
|
|
48850
|
+
issue: The changed code produces wrong behavior.
|
|
48834
48851
|
results: []
|
|
48835
48852
|
- id: testing.application
|
|
48836
48853
|
scope: review
|
|
48837
48854
|
default_severity: consider
|
|
48838
48855
|
issue: >-
|
|
48839
|
-
Required behavior lacks outside-in test evidence (e2e
|
|
48856
|
+
Required behavior lacks outside-in test evidence (e2e over integration over unit), or tests lack human-verifiable outputs such as snapshots, logs, or JSON payloads.
|
|
48840
48857
|
results: []
|
|
48841
48858
|
- id: testing.relevance
|
|
48842
48859
|
scope: applicable-file
|
|
48843
48860
|
applies_when: Added or modified test files.
|
|
48844
48861
|
default_severity: consider
|
|
48845
48862
|
issue: >-
|
|
48846
|
-
Verbose unit tests pad coverage without proving real contracts
|
|
48863
|
+
Verbose unit tests pad coverage without proving real contracts or exercise only external dependencies. Tests inspect static asset or template structure, test the test apparatus, or add same-changeset or alpha regression tests.
|
|
48847
48864
|
results: []
|
|
48848
48865
|
- id: testing.names
|
|
48849
48866
|
scope: applicable-file
|
|
48850
48867
|
applies_when: Added or modified test files.
|
|
48851
48868
|
default_severity: consider
|
|
48852
48869
|
issue: >-
|
|
48853
|
-
A test name
|
|
48870
|
+
A test name omits the tested functionality or its expected outcome.
|
|
48854
48871
|
results: []
|
|
48855
48872
|
- id: testing.arrange-act-assert
|
|
48856
48873
|
scope: applicable-file
|
|
48857
48874
|
applies_when: Added or modified test files.
|
|
48858
48875
|
default_severity: consider
|
|
48859
48876
|
issue: >-
|
|
48860
|
-
Test organization lacks clear BDD
|
|
48877
|
+
Test organization lacks clear BDD structure (given, when, then) or mixes setup, actions, and assertions.
|
|
48861
48878
|
results: []
|
|
48862
48879
|
- id: testing.fixtures
|
|
48863
48880
|
scope: applicable-file
|
|
48864
48881
|
applies_when: Added or modified tests, fixtures, test setup, or test utility files.
|
|
48865
48882
|
default_severity: consider
|
|
48866
48883
|
issue: >-
|
|
48867
|
-
Repeated setup, unsuitable fixtures, or
|
|
48884
|
+
Repeated setup, unsuitable fixtures, or duplicated helpers obscure tests.
|
|
48868
48885
|
results: []
|
|
48869
48886
|
- title: Documentation
|
|
48870
48887
|
criteria:
|
|
48871
48888
|
- id: documentation.conciseness
|
|
48872
48889
|
scope: applicable-file
|
|
48873
|
-
applies_when: Added or modified documentation
|
|
48890
|
+
applies_when: Added or modified documentation and documentation comments.
|
|
48874
48891
|
default_severity: consider
|
|
48875
|
-
issue: Long, dense, or complex
|
|
48892
|
+
issue: Long, dense, or complex prose makes documentation hard to read.
|
|
48876
48893
|
results: []
|
|
48877
48894
|
- id: documentation.redundancy
|
|
48878
48895
|
scope: applicable-file
|
|
48879
|
-
applies_when: Added or modified documentation
|
|
48896
|
+
applies_when: Added or modified documentation and documentation comments.
|
|
48880
48897
|
default_severity: consider
|
|
48881
|
-
issue: Documentation repeats
|
|
48898
|
+
issue: Documentation repeats code or existing prose without adding context.
|
|
48882
48899
|
results: []
|
|
48883
48900
|
- id: documentation.visuals
|
|
48884
48901
|
scope: applicable-file
|
|
48885
48902
|
applies_when: Added or modified documentation that explains structures, flows, or relationships.
|
|
48886
48903
|
default_severity: consider
|
|
48887
|
-
issue:
|
|
48904
|
+
issue: Long prose hides structure or flow that a diagram or tree shows clearly.
|
|
48905
|
+
results: []
|
|
48906
|
+
- id: documentation.requirements
|
|
48907
|
+
scope: applicable-file
|
|
48908
|
+
applies_when: >-
|
|
48909
|
+
Added or modified plans, architecture designs, PRDs, or planning intents with Requirement or Requirements sections.
|
|
48910
|
+
default_severity: consider
|
|
48911
|
+
issue: >-
|
|
48912
|
+
Requirement or Requirements sections use FR or NFR prefixes or state internal implementation specifications. Requirements omit observable behavior or performance, security, cost, isolation, and reliability characteristics from a client or end-user perspective.
|
|
48888
48913
|
results: []
|
|
48889
48914
|
- title: Performance
|
|
48890
48915
|
criteria:
|
|
48891
48916
|
- id: performance.regressions
|
|
48892
48917
|
scope: review
|
|
48893
48918
|
default_severity: consider
|
|
48894
|
-
issue: The change
|
|
48919
|
+
issue: The change introduces a material performance regression.
|
|
48895
48920
|
results: []
|
|
48896
48921
|
- title: Security
|
|
48897
48922
|
optional: true
|
|
@@ -48909,19 +48934,19 @@ var planning_intent_default = `# Intent: [short name]
|
|
|
48909
48934
|
|
|
48910
48935
|
## Objective
|
|
48911
48936
|
|
|
48912
|
-
[
|
|
48937
|
+
[State what you want to add or change for clients, callers, or end users.]
|
|
48913
48938
|
|
|
48914
48939
|
## Requirements/Instructions
|
|
48915
48940
|
|
|
48916
|
-
[
|
|
48941
|
+
[List observable behavioral capabilities from a client, caller, or end-user perspective, or write direct instructions to follow. Use plain statements without \`FR\` or \`NFR\` prefixes. Leave internal types, function names, configuration internals, file layouts, and code-style rules out of requirements.]
|
|
48917
48942
|
|
|
48918
48943
|
## Constraints
|
|
48919
48944
|
|
|
48920
|
-
[
|
|
48945
|
+
[State observable performance, security, cost, isolation, and reliability characteristics, key invariants, or explicit boundaries. Optional.]
|
|
48921
48946
|
|
|
48922
48947
|
## Open Questions
|
|
48923
48948
|
|
|
48924
|
-
[
|
|
48949
|
+
[List product or design decisions that need input before planning. Optional.]
|
|
48925
48950
|
`;
|
|
48926
48951
|
var init_planning_intent = () => {};
|
|
48927
48952
|
|
|
@@ -49559,25 +49584,26 @@ Dual writes increase latency and allow partial failure. Record discrepancies and
|
|
|
49559
49584
|
var init_plan_migration = () => {};
|
|
49560
49585
|
|
|
49561
49586
|
// templates/examples/design-service.md
|
|
49562
|
-
var design_service_default = `# Notification service
|
|
49587
|
+
var design_service_default = `# Notification service: software architecture
|
|
49563
49588
|
|
|
49564
49589
|
## Overview
|
|
49565
49590
|
|
|
49566
|
-
The service
|
|
49591
|
+
The notification service sends email notifications for account events. Callers submit events without waiting for email delivery. The service does not choose notification recipients.
|
|
49567
49592
|
|
|
49568
49593
|
## Requirement
|
|
49569
49594
|
|
|
49570
49595
|
### Functional
|
|
49571
49596
|
|
|
49572
|
-
-
|
|
49573
|
-
-
|
|
49574
|
-
-
|
|
49597
|
+
- Callers submit account events with an event ID, event type, recipient address, and timestamp, and the service rejects malformed events.
|
|
49598
|
+
- Recipients receive an email for each valid account event, and callers can inspect the delivery outcome for each event.
|
|
49599
|
+
- The service retries temporary email failures automatically and reports permanent rejections.
|
|
49575
49600
|
|
|
49576
49601
|
### Non-Functional
|
|
49577
49602
|
|
|
49578
|
-
-
|
|
49579
|
-
-
|
|
49580
|
-
-
|
|
49603
|
+
- Submitting the same event ID more than once sends at most one email to the recipient.
|
|
49604
|
+
- Callers submit events without holding email provider credentials, and event payloads never expose secrets.
|
|
49605
|
+
- Event bursts do not add latency to caller account requests, and operators receive an alert when pending deliveries grow.
|
|
49606
|
+
- Duplicate and permanently rejected events do not trigger paid provider retries.
|
|
49581
49607
|
|
|
49582
49608
|
## Design
|
|
49583
49609
|
|
|
@@ -49592,32 +49618,32 @@ flowchart LR
|
|
|
49592
49618
|
Consumer --> Store[(Attempt store)]
|
|
49593
49619
|
\`\`\`
|
|
49594
49620
|
|
|
49595
|
-
- The account service publishes events and
|
|
49596
|
-
- The durable queue
|
|
49597
|
-
- The consumer
|
|
49598
|
-
- The attempt store records event IDs, delivery outcomes, and retry
|
|
49621
|
+
- The account service publishes events and depends only on the event contract.
|
|
49622
|
+
- The durable queue decouples email delivery from account requests and retries temporary failures.
|
|
49623
|
+
- The consumer parses and deduplicates events before the sender submits mail to the provider.
|
|
49624
|
+
- The attempt store records event IDs, delivery outcomes, and retry counts.
|
|
49599
49625
|
|
|
49600
49626
|
### Data and Control Flow
|
|
49601
49627
|
|
|
49602
|
-
An account event enters the queue. The consumer
|
|
49628
|
+
An account event enters the queue. The consumer parses the payload and queries the attempt store for the event ID before the sender calls the provider. The consumer records each attempt. The queue retries temporary failures, and the consumer reports permanent rejections. Synchronous delivery avoids the queue, but slow provider responses then delay account requests.
|
|
49603
49629
|
|
|
49604
49630
|
### Interfaces and Contracts
|
|
49605
49631
|
|
|
49606
|
-
\`AccountEvent\` contains \`id\`, \`type\`, \`recipient\`, and \`timestamp\`. \`handle(event)\`
|
|
49632
|
+
\`AccountEvent\` contains \`id\`, \`type\`, \`recipient\`, and \`timestamp\`. \`handle(event)\` processes the event, \`send(message)\` calls the provider, and \`record(attempt)\` saves the result. The event ID acts as the deduplication key. Provider credentials never enter the event payload.
|
|
49607
49633
|
|
|
49608
49634
|
## Implementation
|
|
49609
49635
|
|
|
49610
49636
|
### Consumer and storage
|
|
49611
49637
|
|
|
49612
|
-
The notification service owns
|
|
49638
|
+
The notification service owns the consumer and attempt store. The account service imports only the event contract. Save the deduplication key with the delivery outcome so queue redelivery stays safe. Integration tests cover duplicate events and provider timeouts.
|
|
49613
49639
|
|
|
49614
49640
|
### Delivery operations
|
|
49615
49641
|
|
|
49616
|
-
Keep provider credentials
|
|
49642
|
+
Keep provider credentials inside the notification service configuration. Alert operators when the queue grows or when provider calls fail repeatedly. If credentials leak, disable sending and drain pending work. Load tests cover event bursts so account request latency stays flat.
|
|
49617
49643
|
|
|
49618
49644
|
## References
|
|
49619
49645
|
|
|
49620
|
-
- EX-34
|
|
49646
|
+
- EX-34: example notification requirement.
|
|
49621
49647
|
`;
|
|
49622
49648
|
var init_design_service = () => {};
|
|
49623
49649
|
|
|
@@ -52600,7 +52626,7 @@ function createProgram(write = console.log, version = "0.1.0", options = {}) {
|
|
|
52600
52626
|
|
|
52601
52627
|
// src/index.ts
|
|
52602
52628
|
init_errors3();
|
|
52603
|
-
var version2 = "0.13.
|
|
52629
|
+
var version2 = "0.13.1";
|
|
52604
52630
|
try {
|
|
52605
52631
|
await createProgram(console.log, version2).parseAsync(process.argv);
|
|
52606
52632
|
} catch (error) {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@difflab/difflab-cli",
|
|
3
|
-
"version": "0.13.
|
|
3
|
+
"version": "0.13.1",
|
|
4
4
|
"private": false,
|
|
5
5
|
"description": "A minimal Bun CLI starter built with Commander",
|
|
6
6
|
"license": "Apache-2.0",
|
|
@@ -47,7 +47,7 @@
|
|
|
47
47
|
},
|
|
48
48
|
"devDependencies": {
|
|
49
49
|
"@types/bun": "1.4.2",
|
|
50
|
-
"difflab-db": "workspace:*",
|
|
50
|
+
"difflab-db-legacy": "workspace:*",
|
|
51
51
|
"prettier": "3.9.8",
|
|
52
52
|
"typescript": "7.0.2",
|
|
53
53
|
"utils": "workspace:*"
|