@fro.bot/systematic 3.24.1 → 3.25.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/HARNESSES.md +18 -11
- package/dist/cli.js +305 -186
- package/dist/{index-vkmdceqk.js → index-bmsgc2em.js} +9 -10
- package/dist/index.js +1 -1
- package/dist/lib/config.d.ts +23 -7
- package/dist/lib/pi-subagents-export.d.ts +40 -7
- package/dist/lib/pi-subagents-personas.d.ts +9 -0
- package/dist/pi-subagents/agents/systematic-adversarial-document-reviewer.md +87 -0
- package/dist/pi-subagents/agents/systematic-adversarial-reviewer.md +102 -0
- package/dist/pi-subagents/agents/systematic-api-contract-reviewer.md +43 -0
- package/dist/pi-subagents/agents/systematic-architecture-strategist.md +50 -0
- package/dist/pi-subagents/agents/systematic-best-practices-researcher.md +112 -0
- package/dist/pi-subagents/agents/systematic-bug-reproduction-validator.md +88 -0
- package/dist/pi-subagents/agents/systematic-cli-readiness-reviewer.md +65 -0
- package/dist/pi-subagents/agents/systematic-code-simplicity-reviewer.md +84 -0
- package/dist/pi-subagents/agents/systematic-coherence-reviewer.md +37 -0
- package/dist/pi-subagents/agents/systematic-correctness-reviewer.md +43 -0
- package/dist/pi-subagents/agents/systematic-data-migrations-reviewer.md +47 -0
- package/dist/pi-subagents/agents/systematic-deployment-verification-agent.md +157 -0
- package/dist/pi-subagents/agents/systematic-design-lens-reviewer.md +44 -0
- package/dist/pi-subagents/agents/systematic-feasibility-reviewer.md +40 -0
- package/dist/pi-subagents/agents/systematic-framework-docs-researcher.md +91 -0
- package/dist/pi-subagents/agents/systematic-git-history-analyzer.md +44 -0
- package/dist/pi-subagents/agents/systematic-issue-intelligence-analyst.md +207 -0
- package/dist/pi-subagents/agents/systematic-maintainability-reviewer.md +43 -0
- package/dist/pi-subagents/agents/systematic-pattern-recognition-specialist.md +55 -0
- package/dist/pi-subagents/agents/systematic-performance-reviewer.md +45 -0
- package/dist/pi-subagents/agents/systematic-previous-comments-reviewer.md +59 -0
- package/dist/pi-subagents/agents/systematic-product-lens-reviewer.md +68 -0
- package/dist/pi-subagents/agents/systematic-reliability-reviewer.md +43 -0
- package/dist/pi-subagents/agents/systematic-repo-research-analyst.md +322 -0
- package/dist/pi-subagents/agents/systematic-scope-guardian-reviewer.md +52 -0
- package/dist/pi-subagents/agents/systematic-security-lens-reviewer.md +36 -0
- package/dist/pi-subagents/agents/systematic-security-reviewer.md +45 -0
- package/dist/pi-subagents/agents/systematic-spec-flow-analyzer.md +82 -0
- package/dist/pi-subagents/agents/systematic-testing-reviewer.md +43 -0
- package/dist/pi.js +186 -12
- package/package.json +17 -9
- package/skills/using-systematic/references/pi-profile.md +12 -8
package/dist/pi.js
CHANGED
|
@@ -10746,19 +10746,18 @@ function sortAuthorities(authorities) {
|
|
|
10746
10746
|
function sortProtectedFields(fields) {
|
|
10747
10747
|
return [...fields].sort((left, right) => left.fieldPath === right.fieldPath ? left.sourceKind.localeCompare(right.sourceKind) : left.fieldPath.localeCompare(right.fieldPath));
|
|
10748
10748
|
}
|
|
10749
|
+
function isAgentDisabled(disabledAgents, agentOverlays, category, key) {
|
|
10750
|
+
const qualifiedId = category ? `${category}/${key}` : key;
|
|
10751
|
+
if (disabledAgents.has(key) || disabledAgents.has(qualifiedId))
|
|
10752
|
+
return true;
|
|
10753
|
+
return agentOverlays[key]?.value.disable === true || agentOverlays[qualifiedId]?.value.disable === true;
|
|
10754
|
+
}
|
|
10749
10755
|
function collectRoutingTargets(overlays, disabledAgents = new Set) {
|
|
10750
10756
|
const targets = new Map;
|
|
10751
|
-
const isDisabled = (agentKey, category) => {
|
|
10752
|
-
const qualifiedId = `${category}/${agentKey}`;
|
|
10753
|
-
if (disabledAgents.has(agentKey) || disabledAgents.has(qualifiedId)) {
|
|
10754
|
-
return true;
|
|
10755
|
-
}
|
|
10756
|
-
const overlay = overlays.agents[agentKey]?.value ?? overlays.agents[qualifiedId]?.value;
|
|
10757
|
-
return overlay?.disable === true;
|
|
10758
|
-
};
|
|
10759
10757
|
const addTarget = (agentKey, category) => {
|
|
10760
|
-
if (
|
|
10758
|
+
if (isAgentDisabled(disabledAgents, overlays.agents, category, agentKey)) {
|
|
10761
10759
|
return;
|
|
10760
|
+
}
|
|
10762
10761
|
targets.set(`${category}/${agentKey}`, { agentKey, category });
|
|
10763
10762
|
};
|
|
10764
10763
|
for (const rawKey of Object.keys(overlays.agents)) {
|
|
@@ -11447,6 +11446,138 @@ function createDelegateSessionWith(runtime) {
|
|
|
11447
11446
|
}
|
|
11448
11447
|
var createRealPiDelegateSession = createDelegateSessionWith(REAL_PI_DELEGATE_SESSION_RUNTIME);
|
|
11449
11448
|
|
|
11449
|
+
// src/lib/pi-subagents-personas.ts
|
|
11450
|
+
var CURATED_PERSONAS = [
|
|
11451
|
+
{
|
|
11452
|
+
relPath: "agents/research/best-practices-researcher.md",
|
|
11453
|
+
rationale: "Self-contained research persona. INFO: mentions skills in prose as discovery hints, but is operationally independent — no load-skill directive, no parent-dispatch assumption."
|
|
11454
|
+
},
|
|
11455
|
+
{
|
|
11456
|
+
relPath: "agents/research/framework-docs-researcher.md",
|
|
11457
|
+
rationale: "Self-contained framework documentation researcher. No Systematic-only coupling; uses standard tools (Context7, web search, file reads)."
|
|
11458
|
+
},
|
|
11459
|
+
{
|
|
11460
|
+
relPath: "agents/research/git-history-analyzer.md",
|
|
11461
|
+
rationale: "Self-contained git archaeology persona. Uses only standard git CLI + file tools. No skill or orchestration dependencies."
|
|
11462
|
+
},
|
|
11463
|
+
{
|
|
11464
|
+
relPath: "agents/research/issue-intelligence-analyst.md",
|
|
11465
|
+
rationale: "Self-contained GitHub issue analysis persona. Requires only gh CLI + standard file tools. No Systematic-only coupling."
|
|
11466
|
+
},
|
|
11467
|
+
{
|
|
11468
|
+
relPath: "agents/research/repo-research-analyst.md",
|
|
11469
|
+
rationale: "Self-contained repository research persona. Uses standard file/search/glob tools. No Systematic-specific orchestration."
|
|
11470
|
+
},
|
|
11471
|
+
{
|
|
11472
|
+
relPath: "agents/review/adversarial-reviewer.md",
|
|
11473
|
+
rationale: "Self-contained adversarial code reviewer. Fully portable — no Systematic tools or skills required."
|
|
11474
|
+
},
|
|
11475
|
+
{
|
|
11476
|
+
relPath: "agents/review/api-contract-reviewer.md",
|
|
11477
|
+
rationale: "Self-contained API contract reviewer. No Systematic-only coupling."
|
|
11478
|
+
},
|
|
11479
|
+
{
|
|
11480
|
+
relPath: "agents/review/architecture-strategist.md",
|
|
11481
|
+
rationale: "Self-contained architectural reviewer. No Systematic-only coupling."
|
|
11482
|
+
},
|
|
11483
|
+
{
|
|
11484
|
+
relPath: "agents/review/cli-readiness-reviewer.md",
|
|
11485
|
+
rationale: "Self-contained CLI readiness reviewer. No Systematic-only coupling."
|
|
11486
|
+
},
|
|
11487
|
+
{
|
|
11488
|
+
relPath: "agents/review/code-simplicity-reviewer.md",
|
|
11489
|
+
rationale: "Self-contained code simplicity reviewer. No Systematic-only coupling."
|
|
11490
|
+
},
|
|
11491
|
+
{
|
|
11492
|
+
relPath: "agents/review/correctness-reviewer.md",
|
|
11493
|
+
rationale: "Self-contained correctness reviewer. No Systematic-only coupling."
|
|
11494
|
+
},
|
|
11495
|
+
{
|
|
11496
|
+
relPath: "agents/review/data-migrations-reviewer.md",
|
|
11497
|
+
rationale: "Self-contained data migrations reviewer. No Systematic-only coupling."
|
|
11498
|
+
},
|
|
11499
|
+
{
|
|
11500
|
+
relPath: "agents/review/deployment-verification-agent.md",
|
|
11501
|
+
rationale: "Self-contained deployment verification persona. No Systematic-only coupling."
|
|
11502
|
+
},
|
|
11503
|
+
{
|
|
11504
|
+
relPath: "agents/review/maintainability-reviewer.md",
|
|
11505
|
+
rationale: "Self-contained maintainability reviewer. No Systematic-only coupling."
|
|
11506
|
+
},
|
|
11507
|
+
{
|
|
11508
|
+
relPath: "agents/review/pattern-recognition-specialist.md",
|
|
11509
|
+
rationale: "Self-contained pattern recognition reviewer. No Systematic-only coupling."
|
|
11510
|
+
},
|
|
11511
|
+
{
|
|
11512
|
+
relPath: "agents/review/performance-reviewer.md",
|
|
11513
|
+
rationale: "Self-contained performance reviewer. No Systematic-only coupling."
|
|
11514
|
+
},
|
|
11515
|
+
{
|
|
11516
|
+
relPath: "agents/review/previous-comments-reviewer.md",
|
|
11517
|
+
rationale: "Self-contained previous-comments reviewer. Reviews prior feedback. No Systematic-only coupling."
|
|
11518
|
+
},
|
|
11519
|
+
{
|
|
11520
|
+
relPath: "agents/review/reliability-reviewer.md",
|
|
11521
|
+
rationale: "Self-contained reliability reviewer. No Systematic-only coupling."
|
|
11522
|
+
},
|
|
11523
|
+
{
|
|
11524
|
+
relPath: "agents/review/security-reviewer.md",
|
|
11525
|
+
rationale: "Self-contained security reviewer. No Systematic-only coupling."
|
|
11526
|
+
},
|
|
11527
|
+
{
|
|
11528
|
+
relPath: "agents/review/testing-reviewer.md",
|
|
11529
|
+
rationale: "Self-contained testing reviewer. No Systematic-only coupling."
|
|
11530
|
+
},
|
|
11531
|
+
{
|
|
11532
|
+
relPath: "agents/document-review/adversarial-document-reviewer.md",
|
|
11533
|
+
rationale: "Self-contained document reviewer. Challenges premises in plans/specs. No Systematic-only coupling."
|
|
11534
|
+
},
|
|
11535
|
+
{
|
|
11536
|
+
relPath: "agents/document-review/coherence-reviewer.md",
|
|
11537
|
+
rationale: "Self-contained document coherence reviewer. No Systematic-only coupling."
|
|
11538
|
+
},
|
|
11539
|
+
{
|
|
11540
|
+
relPath: "agents/document-review/design-lens-reviewer.md",
|
|
11541
|
+
rationale: "Self-contained design lens reviewer. No Systematic-only coupling."
|
|
11542
|
+
},
|
|
11543
|
+
{
|
|
11544
|
+
relPath: "agents/document-review/feasibility-reviewer.md",
|
|
11545
|
+
rationale: "Self-contained feasibility reviewer. No Systematic-only coupling."
|
|
11546
|
+
},
|
|
11547
|
+
{
|
|
11548
|
+
relPath: "agents/document-review/product-lens-reviewer.md",
|
|
11549
|
+
rationale: "Self-contained product lens reviewer. No Systematic-only coupling."
|
|
11550
|
+
},
|
|
11551
|
+
{
|
|
11552
|
+
relPath: "agents/document-review/scope-guardian-reviewer.md",
|
|
11553
|
+
rationale: "Self-contained scope guardian reviewer. No Systematic-only coupling."
|
|
11554
|
+
},
|
|
11555
|
+
{
|
|
11556
|
+
relPath: "agents/document-review/security-lens-reviewer.md",
|
|
11557
|
+
rationale: "Self-contained security lens reviewer. No Systematic-only coupling."
|
|
11558
|
+
},
|
|
11559
|
+
{
|
|
11560
|
+
relPath: "agents/workflow/spec-flow-analyzer.md",
|
|
11561
|
+
rationale: "Self-contained spec flow analyzer. Analyzes specs for user flow completeness. No Systematic orchestration coupling."
|
|
11562
|
+
},
|
|
11563
|
+
{
|
|
11564
|
+
relPath: "agents/workflow/bug-reproduction-validator.md",
|
|
11565
|
+
rationale: "Self-contained bug reproduction specialist. WARNING: mentions agent-browser skill in prose as an optional tool hint, but does not require Systematic skill loading to operate."
|
|
11566
|
+
}
|
|
11567
|
+
];
|
|
11568
|
+
function parseSourceCategoryAndKey(sourceRelPath) {
|
|
11569
|
+
const parts = sourceRelPath.split("/");
|
|
11570
|
+
if (parts.length >= 3 && parts[0] === "agents") {
|
|
11571
|
+
const fileName = parts.at(-1) ?? "";
|
|
11572
|
+
return {
|
|
11573
|
+
category: parts[1],
|
|
11574
|
+
agentKey: fileName.replace(/\.md$/, "")
|
|
11575
|
+
};
|
|
11576
|
+
}
|
|
11577
|
+
const fileName = parts.at(-1) ?? sourceRelPath;
|
|
11578
|
+
return { category: undefined, agentKey: fileName.replace(/\.md$/, "") };
|
|
11579
|
+
}
|
|
11580
|
+
|
|
11450
11581
|
// src/lib/skill-resolver.ts
|
|
11451
11582
|
import fs7 from "node:fs";
|
|
11452
11583
|
import path6 from "node:path";
|
|
@@ -11750,18 +11881,60 @@ var reportPiDelegateCatalogFailure = (error) => {
|
|
|
11750
11881
|
process.stderr.write(`[systematic] Failed to build Pi agent catalog; systematic_delegate will not be registered: ${message}
|
|
11751
11882
|
`);
|
|
11752
11883
|
};
|
|
11884
|
+
var PACKAGED_OVERLAY_WARNING = "[systematic] systematic.json configures agent or pi_subagents overlays (model, thinking, max_turns, tools or skills). " + "Personas packaged with Systematic ignore overlays; they load with pi-subagents' defaults. " + "Run `systematic pi-subagents export` to write overlay-aware persona files, which outrank the packaged ones.\n";
|
|
11885
|
+
var reportPackagedOverlayIgnored = () => {
|
|
11886
|
+
process.stderr.write(PACKAGED_OVERLAY_WARNING);
|
|
11887
|
+
};
|
|
11888
|
+
var reportPackagedPersonasStillLoad = (count) => {
|
|
11889
|
+
process.stderr.write(`[systematic] ${count} persona(s) disabled in systematic.json still load in pi-subagents from the Systematic package, ` + "which has no access to that setting. " + "To stop them loading, disable one with /agents → Disable, or set `packageAgents: false` in subagents.json to turn off every packaged persona. " + `This notice repeats on each start while the setting is present, because Systematic cannot read pi-subagents' own settings.
|
|
11890
|
+
`);
|
|
11891
|
+
};
|
|
11892
|
+
var WARNINGS_EMITTED_KEY = Symbol.for("systematic.pi.packagedWarningsEmitted");
|
|
11893
|
+
function claimPackagedWarnings() {
|
|
11894
|
+
if (Reflect.get(globalThis, WARNINGS_EMITTED_KEY) === true)
|
|
11895
|
+
return false;
|
|
11896
|
+
Reflect.set(globalThis, WARNINGS_EMITTED_KEY, true);
|
|
11897
|
+
return true;
|
|
11898
|
+
}
|
|
11899
|
+
var PI_CONSUMED_ROUTING_FIELDS = ["model", "pi"];
|
|
11900
|
+
function hasPiConsumedRoutingField(overlays) {
|
|
11901
|
+
return Object.values(overlays).some(({ value }) => PI_CONSUMED_ROUTING_FIELDS.some((field) => Object.hasOwn(value, field)));
|
|
11902
|
+
}
|
|
11903
|
+
function hasOverlaysPackagedPersonasIgnore(routing, piSubagents) {
|
|
11904
|
+
return hasPiConsumedRoutingField(routing.agents) || hasPiConsumedRoutingField(routing.categories) || hasNonEmptyEntry(piSubagents?.agents) || hasNonEmptyEntry(piSubagents?.categories);
|
|
11905
|
+
}
|
|
11906
|
+
function hasNonEmptyEntry(entries) {
|
|
11907
|
+
return Object.values(entries ?? {}).some((entry) => Object.keys(entry).length > 0);
|
|
11908
|
+
}
|
|
11909
|
+
function countDisabledPackagedPersonas(config, routing) {
|
|
11910
|
+
const disabledAgents = new Set(config.disabled_agents);
|
|
11911
|
+
return CURATED_PERSONAS.filter((persona) => {
|
|
11912
|
+
const { category, agentKey } = parseSourceCategoryAndKey(persona.relPath);
|
|
11913
|
+
return isAgentDisabled(disabledAgents, routing.agents, category ?? "", agentKey);
|
|
11914
|
+
}).length;
|
|
11915
|
+
}
|
|
11753
11916
|
var defaultPiExtensionDependencies = {
|
|
11754
11917
|
buildAgentCatalog
|
|
11755
11918
|
};
|
|
11756
11919
|
async function systematicPiExtension(pi, deps = defaultPiExtensionDependencies) {
|
|
11757
11920
|
const { buildAgentCatalog: buildAgentCatalogFn = buildAgentCatalog } = deps;
|
|
11758
|
-
const disabledSkills = [];
|
|
11759
|
-
const resolverOptions = { bundledSkillsDir, disabledSkills };
|
|
11760
11921
|
const {
|
|
11761
11922
|
config: piConfig,
|
|
11762
11923
|
metadata: piConfigMetadata,
|
|
11763
11924
|
overlays: piRoutingOverlays
|
|
11764
11925
|
} = loadConfigWithSources(process.cwd());
|
|
11926
|
+
const overlaysIgnored = hasOverlaysPackagedPersonasIgnore(piRoutingOverlays, piConfig.pi_subagents);
|
|
11927
|
+
const disabledPackaged = countDisabledPackagedPersonas(piConfig, piRoutingOverlays);
|
|
11928
|
+
if ((overlaysIgnored || disabledPackaged > 0) && claimPackagedWarnings()) {
|
|
11929
|
+
if (overlaysIgnored)
|
|
11930
|
+
reportPackagedOverlayIgnored();
|
|
11931
|
+
if (disabledPackaged > 0)
|
|
11932
|
+
reportPackagedPersonasStillLoad(disabledPackaged);
|
|
11933
|
+
}
|
|
11934
|
+
const resolverOptions = {
|
|
11935
|
+
bundledSkillsDir,
|
|
11936
|
+
disabledSkills: piConfig.disabled_skills
|
|
11937
|
+
};
|
|
11765
11938
|
const bootstrapContent = computeBootstrapContentSafe({
|
|
11766
11939
|
bundledSkillsDir,
|
|
11767
11940
|
usageTemplate: PI_BOOTSTRAP_USAGE_TEMPLATE,
|
|
@@ -11793,7 +11966,8 @@ async function systematicPiExtension(pi, deps = defaultPiExtensionDependencies)
|
|
|
11793
11966
|
}
|
|
11794
11967
|
});
|
|
11795
11968
|
try {
|
|
11796
|
-
const
|
|
11969
|
+
const disabledAgents = new Set(piConfig.disabled_agents);
|
|
11970
|
+
const catalog = buildAgentCatalogFn(bundledAgentsDir).filter((entry) => !isAgentDisabled(disabledAgents, piRoutingOverlays.agents, entry.category, entry.key));
|
|
11797
11971
|
pi.registerTool(createPiDelegateTool({
|
|
11798
11972
|
catalog,
|
|
11799
11973
|
createDelegateSession: createRealPiDelegateSession,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fro.bot/systematic",
|
|
3
|
-
"version": "3.
|
|
3
|
+
"version": "3.25.0",
|
|
4
4
|
"description": "Compound-engineering loops for OpenCode, Pi, and Claude Code",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"homepage": "https://fro.bot/systematic",
|
|
@@ -20,7 +20,12 @@
|
|
|
20
20
|
],
|
|
21
21
|
"skills": [
|
|
22
22
|
"./skills"
|
|
23
|
-
]
|
|
23
|
+
],
|
|
24
|
+
"subagents": {
|
|
25
|
+
"agents": [
|
|
26
|
+
"./dist/pi-subagents/agents"
|
|
27
|
+
]
|
|
28
|
+
}
|
|
24
29
|
},
|
|
25
30
|
"files": [
|
|
26
31
|
"dist",
|
|
@@ -34,7 +39,7 @@
|
|
|
34
39
|
],
|
|
35
40
|
"scripts": {
|
|
36
41
|
"clean": "rimraf dist",
|
|
37
|
-
"build": "bun run clean && bun build src/index.ts src/cli.ts --outdir dist --target bun --splitting --external @opencode-ai/plugin --external js-yaml && bun build src/pi.ts --outdir dist --target node --external @earendil-works/pi-coding-agent --external typebox --external jsonc-parser && tsc --emitDeclarationOnly",
|
|
42
|
+
"build": "bun run clean && bun build src/index.ts src/cli.ts --outdir dist --target bun --splitting --external @opencode-ai/plugin --external js-yaml && bun build src/pi.ts --outdir dist --target node --external @earendil-works/pi-coding-agent --external typebox --external jsonc-parser && tsc --emitDeclarationOnly && bun scripts/build-pi-package-agents.ts",
|
|
38
43
|
"dev": "bun --watch src/index.ts",
|
|
39
44
|
"test": "bun test tests/unit",
|
|
40
45
|
"test:integration": "bun test tests/integration",
|
|
@@ -69,7 +74,8 @@
|
|
|
69
74
|
"plugin",
|
|
70
75
|
"ai",
|
|
71
76
|
"workflow",
|
|
72
|
-
"engineering"
|
|
77
|
+
"engineering",
|
|
78
|
+
"pi-package"
|
|
73
79
|
],
|
|
74
80
|
"author": "Marcus R. Brown <human@fro.bot>",
|
|
75
81
|
"license": "MIT",
|
|
@@ -82,7 +88,7 @@
|
|
|
82
88
|
},
|
|
83
89
|
"peerDependencies": {
|
|
84
90
|
"@opencode-ai/plugin": "^1.1.30",
|
|
85
|
-
"@earendil-works/pi-coding-agent": "^0.
|
|
91
|
+
"@earendil-works/pi-coding-agent": "^1.0.0",
|
|
86
92
|
"typebox": "^1.1.38"
|
|
87
93
|
},
|
|
88
94
|
"peerDependenciesMeta": {
|
|
@@ -98,11 +104,11 @@
|
|
|
98
104
|
},
|
|
99
105
|
"devDependencies": {
|
|
100
106
|
"@biomejs/biome": "2.5.15",
|
|
101
|
-
"@earendil-works/pi-coding-agent": "
|
|
107
|
+
"@earendil-works/pi-coding-agent": "1.3.0",
|
|
102
108
|
"@opencode-ai/plugin": "1.19.3",
|
|
103
109
|
"@opencode-ai/sdk": "1.19.3",
|
|
104
110
|
"@semantic-release/exec": "7.1.0",
|
|
105
|
-
"@tintinweb/pi-subagents": "0.
|
|
111
|
+
"@tintinweb/pi-subagents": "0.22.0",
|
|
106
112
|
"@types/bun": "latest",
|
|
107
113
|
"@types/js-yaml": "4.0.9",
|
|
108
114
|
"@types/node": "26.6.5",
|
|
@@ -123,13 +129,15 @@
|
|
|
123
129
|
"zod": "4.6.7"
|
|
124
130
|
},
|
|
125
131
|
"overrides": {
|
|
126
|
-
"@earendil-works/pi-ai": "
|
|
132
|
+
"@earendil-works/pi-ai": "1.3.0",
|
|
127
133
|
"brace-expansion": "^5.0.8",
|
|
128
134
|
"conventional-changelog-writer": ">=9",
|
|
129
135
|
"devalue": "^5.9.3",
|
|
130
136
|
"fast-uri": "~3.1.7",
|
|
137
|
+
"markdown-it": "~14.3.3",
|
|
131
138
|
"smol-toml": "~1.9.0",
|
|
132
|
-
"source-map-js": "^1.2.2"
|
|
139
|
+
"source-map-js": "^1.2.2",
|
|
140
|
+
"vite": "~8.3.0"
|
|
133
141
|
},
|
|
134
142
|
"publishConfig": {
|
|
135
143
|
"access": "public",
|
|
@@ -4,7 +4,7 @@ Evidence registry: see [`HARNESSES.md`](../../../HARNESSES.md).
|
|
|
4
4
|
|
|
5
5
|
| Capability | Mechanism | Status | Fallback |
|
|
6
6
|
|---|---|---|---|
|
|
7
|
-
| Subagent delegation | Bounded built-in delegate via `systematic_delegate({agent, task})`; optional mature delegation via [pi-subagents](https://github.com/tintinweb/pi-subagents)
|
|
7
|
+
| Subagent delegation | Bounded built-in delegate via `systematic_delegate({agent, task})`; optional mature delegation via [pi-subagents](https://github.com/tintinweb/pi-subagents): installed package personas, opt-in export for overlays | built-in: degraded (sequential only); pi-subagents path: outside Systematic's bounded-delegate guarantees | Dispatch sequentially in dependency order or do the work inline |
|
|
8
8
|
| Blocking user interaction | No native blocking tool | degraded | Present numbered options in chat and wait |
|
|
9
9
|
| Task tracking | No native task-tracking mechanism | unavailable | Maintain a visible task list in responses |
|
|
10
10
|
| Skill loading | `systematic_skill` tool or Pi-native skill activation | supported | Read the skill instructions listed by the active harness |
|
|
@@ -15,18 +15,24 @@ Evidence registry: see [`HARNESSES.md`](../../../HARNESSES.md).
|
|
|
15
15
|
|
|
16
16
|
```typescript
|
|
17
17
|
systematic_delegate({
|
|
18
|
-
agent: "
|
|
19
|
-
task: "
|
|
18
|
+
agent: "repo-research-analyst",
|
|
19
|
+
task: "Map how the auth module is wired and list the files involved.",
|
|
20
20
|
})
|
|
21
21
|
```
|
|
22
22
|
|
|
23
|
+
`systematic_delegate` takes the bare name; the pi-subagents `Agent` tool takes `systematic-<name>`.
|
|
24
|
+
|
|
23
25
|
`systematic_delegate` is sequential, capped at 20 turns, depth-1, and spawns its child with `noExtensions: true`. The `noExtensions` guarantee bounds `systematic_delegate`'s own recursion — it does not bound end-to-end delegation depth across a combined pi-subagents + Systematic path.
|
|
24
26
|
|
|
25
27
|
### Optional: pi-subagents delegation
|
|
26
28
|
|
|
27
|
-
|
|
29
|
+
[pi-subagents](https://github.com/tintinweb/pi-subagents) (parallel/multi-model delegation) 0.22 or newer loads 29 curated personas from the installed package as `systematic-<name>` agent types with plain defaults; a project-scope install only after the project is trusted, and its first session may omit them from the `Agent` description, though dispatch works. Any other type falls back to `general-purpose` with an "Unknown agent type" note: the persona did not run. Export is needed only to apply `systematic.json` overlays; a local file outranks the packaged one. Nothing is written at extension load.
|
|
30
|
+
|
|
31
|
+
`disabled_agents` and `agents.<name>.disable` do not reach packaged personas. Turn one off with `/agents → Disable`, or all with `packageAgents: false` in `subagents.json`.
|
|
28
32
|
|
|
29
|
-
|
|
33
|
+
The `Agent` tool runs in the background by default. Pass `run_in_background: false` to wait for the result.
|
|
34
|
+
|
|
35
|
+
Tested against pi-subagents 0.22.0 on Pi 1.3.0. Versions outside the tested range are unsupported but nonfatal.
|
|
30
36
|
|
|
31
37
|
Exact CLI form: `systematic pi-subagents <preview|export|refresh|cleanup> --scope project|global`. `--scope` is optional and defaults to `project`.
|
|
32
38
|
|
|
@@ -42,9 +48,7 @@ systematic pi-subagents cleanup [--scope project|global]
|
|
|
42
48
|
|
|
43
49
|
The pi-subagents delegation path is **outside Systematic's bounded-delegate guarantees** and governed by pi-subagents' own configuration. `systematic_delegate` remains the bounded default.
|
|
44
50
|
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
Systematic's own config (`systematic.json`/`.jsonc`) is the durable source of truth for exported personas; the generated files and their manifest are a disposable projection that `export`/`refresh`/`cleanup` regenerate or remove, and `refresh` intentionally overwrites manifest-owned generated files that diverge from current config — run `preview` first to see what would change. See the [pi-subagents pairing guide](https://fro.bot/systematic/guides/pi-subagents/) for the config precedence, trust boundaries, and a canonical example.
|
|
51
|
+
Locking, ownership, config precedence and trust boundaries: see [`HARNESSES.md`](../../../HARNESSES.md) and the [pi-subagents pairing guide](https://fro.bot/systematic/guides/pi-subagents/).
|
|
48
52
|
|
|
49
53
|
### Blocking user interaction
|
|
50
54
|
|