@shardworks/spider-apparatus 0.1.199 → 0.1.201

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.
@@ -2,11 +2,20 @@
2
2
  * Implement engine — quick (Animator-backed).
3
3
  *
4
4
  * Summons an anima to do the commissioned work. Wraps the writ body with
5
- * a commit instruction, then calls animator.summon() with the draft
6
- * worktree as the working directory. Returns `{ status: 'launched', sessionId }`
7
- * so the Spider's collect step can poll for completion on subsequent walks.
5
+ * task-manifest-aware execution instructions, then calls animator.summon()
6
+ * with the draft worktree as the working directory. Returns
7
+ * `{ status: 'launched', sessionId }` so the Spider's collect step can poll
8
+ * for completion on subsequent walks.
8
9
  */
9
10
  import type { EngineDesign } from '@shardworks/fabricator-apparatus';
11
+ /**
12
+ * Execution instructions appended to the writ body. When the body contains
13
+ * a `<task-manifest>`, the anima works through tasks in order, running each
14
+ * task's `<verify>` command as a checkpoint and committing after each task
15
+ * or logical group. If no manifest is present, behaviour is unchanged.
16
+ */
17
+ declare const EXECUTION_EPILOGUE = "\nIf the specification above contains a <task-manifest>, follow these execution rules:\n\n1. Work through tasks in the order listed (t1, t2, t3, \u2026).\n2. After completing each task, run its <verify> command and confirm the <done> criterion is met before moving on.\n3. Commit after each task (or after a logical group of tightly-coupled tasks).\n4. The <files> element in each task is the planner's predicted blast radius \u2014 useful for orientation, but verify scope independently. Do not limit your changes to only the listed files.\n5. If a task reveals additional work not covered by the manifest, do it inline before proceeding to the next task.\n\nCommit all changes before ending your session.";
10
18
  declare const implementEngine: EngineDesign;
19
+ export { EXECUTION_EPILOGUE };
11
20
  export default implementEngine;
12
21
  //# sourceMappingURL=implement.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"implement.d.ts","sourceRoot":"","sources":["../../src/engines/implement.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAKrE,QAAA,MAAM,eAAe,EAAE,YAoBtB,CAAC;AAEF,eAAe,eAAe,CAAC"}
1
+ {"version":3,"file":"implement.d.ts","sourceRoot":"","sources":["../../src/engines/implement.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAKrE;;;;;GAKG;AACH,QAAA,MAAM,kBAAkB,usBASuB,CAAC;AAEhD,QAAA,MAAM,eAAe,EAAE,YAoBtB,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC9B,eAAe,eAAe,CAAC"}
@@ -2,18 +2,35 @@
2
2
  * Implement engine — quick (Animator-backed).
3
3
  *
4
4
  * Summons an anima to do the commissioned work. Wraps the writ body with
5
- * a commit instruction, then calls animator.summon() with the draft
6
- * worktree as the working directory. Returns `{ status: 'launched', sessionId }`
7
- * so the Spider's collect step can poll for completion on subsequent walks.
5
+ * task-manifest-aware execution instructions, then calls animator.summon()
6
+ * with the draft worktree as the working directory. Returns
7
+ * `{ status: 'launched', sessionId }` so the Spider's collect step can poll
8
+ * for completion on subsequent walks.
8
9
  */
9
10
  import { guild } from '@shardworks/nexus-core';
11
+ /**
12
+ * Execution instructions appended to the writ body. When the body contains
13
+ * a `<task-manifest>`, the anima works through tasks in order, running each
14
+ * task's `<verify>` command as a checkpoint and committing after each task
15
+ * or logical group. If no manifest is present, behaviour is unchanged.
16
+ */
17
+ const EXECUTION_EPILOGUE = `
18
+ If the specification above contains a <task-manifest>, follow these execution rules:
19
+
20
+ 1. Work through tasks in the order listed (t1, t2, t3, …).
21
+ 2. After completing each task, run its <verify> command and confirm the <done> criterion is met before moving on.
22
+ 3. Commit after each task (or after a logical group of tightly-coupled tasks).
23
+ 4. The <files> element in each task is the planner's predicted blast radius — useful for orientation, but verify scope independently. Do not limit your changes to only the listed files.
24
+ 5. If a task reveals additional work not covered by the manifest, do it inline before proceeding to the next task.
25
+
26
+ Commit all changes before ending your session.`;
10
27
  const implementEngine = {
11
28
  id: 'implement',
12
29
  async run(givens, context) {
13
30
  const animator = guild().apparatus('animator');
14
31
  const writ = givens.writ;
15
32
  const draft = context.upstream['draft'];
16
- const prompt = `${writ.body}\n\nCommit all changes before ending your session.`;
33
+ const prompt = `${writ.body}\n${EXECUTION_EPILOGUE}`;
17
34
  const handle = animator.summon({
18
35
  role: givens.role,
19
36
  prompt,
@@ -24,5 +41,6 @@ const implementEngine = {
24
41
  return { status: 'launched', sessionId: handle.sessionId };
25
42
  },
26
43
  };
44
+ export { EXECUTION_EPILOGUE };
27
45
  export default implementEngine;
28
46
  //# sourceMappingURL=implement.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"implement.js","sourceRoot":"","sources":["../../src/engines/implement.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAM/C,MAAM,eAAe,GAAiB;IACpC,EAAE,EAAE,WAAW;IAEf,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO;QACvB,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC,SAAS,CAAc,UAAU,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAe,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB,CAAC;QAEvD,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,oDAAoD,CAAC;QAEhF,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YAC7B,IAAI,EAAE,MAAM,CAAC,IAAc;YAC3B,MAAM;YACN,GAAG,EAAE,KAAK,CAAC,IAAI;YACf,WAAW,EAAE,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC,EAAE,cAAc,EAAE;YAC3D,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE;SAC1D,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IAC7D,CAAC;CACF,CAAC;AAEF,eAAe,eAAe,CAAC"}
1
+ {"version":3,"file":"implement.js","sourceRoot":"","sources":["../../src/engines/implement.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAM/C;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG;;;;;;;;;+CASoB,CAAC;AAEhD,MAAM,eAAe,GAAiB;IACpC,EAAE,EAAE,WAAW;IAEf,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO;QACvB,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC,SAAS,CAAc,UAAU,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAe,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB,CAAC;QAEvD,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QAErD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YAC7B,IAAI,EAAE,MAAM,CAAC,IAAc;YAC3B,MAAM;YACN,GAAG,EAAE,KAAK,CAAC,IAAI;YACf,WAAW,EAAE,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC,EAAE,cAAc,EAAE;YAC3D,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE;SAC1D,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IAC7D,CAAC;CACF,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC9B,eAAe,eAAe,CAAC"}
@@ -1,6 +1,6 @@
1
1
  export { default as animaSessionEngine } from './anima-session.ts';
2
2
  export { default as draftEngine } from './draft.ts';
3
- export { default as implementEngine } from './implement.ts';
3
+ export { default as implementEngine, EXECUTION_EPILOGUE } from './implement.ts';
4
4
  export { default as reviewEngine } from './review.ts';
5
5
  export { default as reviseEngine } from './revise.ts';
6
6
  export { default as sealEngine } from './seal.ts';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC"}
@@ -1,6 +1,6 @@
1
1
  export { default as animaSessionEngine } from "./anima-session.js";
2
2
  export { default as draftEngine } from "./draft.js";
3
- export { default as implementEngine } from "./implement.js";
3
+ export { default as implementEngine, EXECUTION_EPILOGUE } from "./implement.js";
4
4
  export { default as reviewEngine } from "./review.js";
5
5
  export { default as reviseEngine } from "./revise.js";
6
6
  export { default as sealEngine } from "./seal.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@shardworks/spider-apparatus",
3
- "version": "0.1.199",
3
+ "version": "0.1.201",
4
4
  "license": "ISC",
5
5
  "repository": {
6
6
  "type": "git",
@@ -22,16 +22,16 @@
22
22
  "hono": "^4.7.11",
23
23
  "yaml": "^2.0.0",
24
24
  "zod": "4.3.6",
25
- "@shardworks/fabricator-apparatus": "0.1.199",
26
- "@shardworks/stacks-apparatus": "0.1.199",
27
- "@shardworks/clerk-apparatus": "0.1.199",
28
- "@shardworks/tools-apparatus": "0.1.199",
29
- "@shardworks/animator-apparatus": "0.1.199",
30
- "@shardworks/codexes-apparatus": "0.1.199"
25
+ "@shardworks/tools-apparatus": "0.1.201",
26
+ "@shardworks/fabricator-apparatus": "0.1.201",
27
+ "@shardworks/stacks-apparatus": "0.1.201",
28
+ "@shardworks/animator-apparatus": "0.1.201",
29
+ "@shardworks/codexes-apparatus": "0.1.201",
30
+ "@shardworks/clerk-apparatus": "0.1.201"
31
31
  },
32
32
  "devDependencies": {
33
33
  "@types/node": "25.5.0",
34
- "@shardworks/nexus-core": "0.1.199"
34
+ "@shardworks/nexus-core": "0.1.201"
35
35
  },
36
36
  "files": [
37
37
  "dist",