@skillstate/core 2.0.2 → 2.0.4

package/dist/schemas/generic-procedure.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Default neutral spec for `skillstate init` — domain-agnostic state-based
+ * execution. Projects differ; the task spec is the user's concern
+ * (`skillstate init --spec <path>`). This schema only fixes the universal
+ * bookkeeping fields every stateful procedure needs.
+ *
+ * The CTF example remains available explicitly via `skillstate init --example ctf`.
+ */
+import type { ProceduralSpec } from '../types.js';
+export declare const GENERIC_PROCEDURE_SPEC: ProceduralSpec;
+//# sourceMappingURL=generic-procedure.d.ts.map

package/dist/schemas/generic-procedure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-procedure.d.ts","sourceRoot":"","sources":["../../src/schemas/generic-procedure.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,eAAO,MAAM,sBAAsB,EAAE,cA8DpC,CAAC"}

package/dist/schemas/generic-procedure.js

@@ -0,0 +1,64 @@
+export const GENERIC_PROCEDURE_SPEC = {
+    id: 'generic-procedure',
+    name: 'State-based Execution',
+    version: '1.0.0',
+    instructions: [
+        'You are operating in state-based execution mode on an arbitrary task.',
+        '',
+        'Your execution state is persisted externally and restored between',
+        'steps. Conversation history is trimmed automatically: never rely on',
+        'it to carry information. Anything you need later MUST go into',
+        'state_patch this step.',
+        '',
+        'Process for every step:',
+        '1. Read the current state and the latest observation.',
+        '2. Reason about the single next action that makes the most progress',
+        '   toward the goal.',
+        '3. Emit a JSON block with exactly two keys:',
+        '   { "state_patch": { ... }, "action": "<what you are doing next>" }',
+        '',
+        'State discipline:',
+        '- Keep `goal` accurate; refine it as understanding improves.',
+        '- Move finished work into `progress`; keep `next_steps` current.',
+        '- Record produced or modified files in `artifacts`.',
+        '- Track unknowns and obstacles in `blockers` instead of memory.',
+        '- Use `notes` for anything else worth persisting.',
+        '- Set a key to null in state_patch to delete it.',
+        '',
+        'Iterate observation -> reasoning -> state_patch -> action until the',
+        'goal is achieved and `progress` reflects it.',
+    ].join('\n'),
+    schema: {
+        goal: {
+            type: 'string',
+            default: '',
+            description: 'What the current procedure is trying to achieve',
+        },
+        progress: {
+            type: 'array',
+            default: [],
+            description: 'Completed steps or milestones',
+        },
+        next_steps: {
+            type: 'array',
+            default: [],
+            description: 'Planned next actions',
+        },
+        artifacts: {
+            type: 'array',
+            default: [],
+            description: 'Files or paths produced or modified so far',
+        },
+        blockers: {
+            type: 'array',
+            default: [],
+            description: 'Current obstacles or unknowns',
+        },
+        notes: {
+            type: 'string',
+            default: '',
+            description: 'Free-form working notes persisted between steps',
+        },
+    },
+};
+//# sourceMappingURL=generic-procedure.js.map

package/dist/schemas/generic-procedure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-procedure.js","sourceRoot":"","sources":["../../src/schemas/generic-procedure.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,sBAAsB,GAAmB;IACpD,EAAE,EAAE,mBAAmB;IACvB,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,OAAO;IAChB,YAAY,EAAE;QACZ,uEAAuE;QACvE,EAAE;QACF,mEAAmE;QACnE,qEAAqE;QACrE,+DAA+D;QAC/D,wBAAwB;QACxB,EAAE;QACF,yBAAyB;QACzB,uDAAuD;QACvD,qEAAqE;QACrE,qBAAqB;QACrB,6CAA6C;QAC7C,sEAAsE;QACtE,EAAE;QACF,mBAAmB;QACnB,8DAA8D;QAC9D,kEAAkE;QAClE,qDAAqD;QACrD,iEAAiE;QACjE,mDAAmD;QACnD,kDAAkD;QAClD,EAAE;QACF,qEAAqE;QACrE,8CAA8C;KAC/C,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,iDAAiD;SAC/D;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,+BAA+B;SAC7C;QACD,UAAU,EAAE;YACV,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,sBAAsB;SACpC;QACD,SAAS,EAAE;YACT,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,4CAA4C;SAC1D;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,+BAA+B;SAC7C;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,iDAAiD;SAC/D;KACF;CACF,CAAC"}

package/dist/schemas/index.d.ts

@@ -1,2 +1,3 @@
 export * from './intercode-ctf.js';
+export * from './generic-procedure.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAEA,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/dist/schemas/index.js

@@ -1,3 +1,5 @@
-// Canonical procedural specifications (paper §3.1 datasets).
+// Canonical procedural specifications (paper §3.1 datasets) plus the
+// neutral default used by `skillstate init` (domain-agnostic).
 export * from './intercode-ctf.js';
+export * from './generic-procedure.js';
 //# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,+DAA+D;AAC/D,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillstate/core",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "Paper-exact skillstate runtime core (A.4 byte-verbatim formatPaper, §4.3 token tracker).",
   "type": "module",
   "main": "dist/index.js",