axstack 0.53.0 → 0.53.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "axstack",
-  "version": "0.53.0",
+  "version": "0.53.1",
   "description": "Axstack installer and setup CLI: installs owned chat skills and role data, configures supported harness settings, and checks T3 Code capabilities.",
   "keywords": [
     "claude-code",

package/skills/axstack/scripts/check-staged-file-tokens.js

@@ -22,38 +22,28 @@ try {
   } catch (error) {
     if (error.code !== 'ENOENT') throw error;
   }
+  if (git('ls-files', '--unmerged', '-z')) throw Error('Unmerged index entries must be resolved before measurement');
   const paths = git('diff', '--cached', '--name-only', '--diff-filter=ACMR', '-z').split('\0').filter(Boolean);
-  const offenders = [];
+  const advisories = [];
   for (const path of paths) {
     if (ignoredPath.test(path) || asset.test(path) || ignores.some((glob) => glob.match(path))) continue;
     if (git('ls-files', '--stage', '-z', '--', path).startsWith('160000 ')) continue;
-    const bytes = Number(git('cat-file', '-s', `:${path}`));
+    const size = git('cat-file', '-s', `:${path}`).trim();
+    const bytes = Number(size);
+    if (!/^\d+$/.test(size) || !Number.isSafeInteger(bytes)) {
+      throw Error(`Invalid blob size for ${JSON.stringify(path)}: ${JSON.stringify(size)}`);
+    }
     if (bytes <= 20000) continue;
     if (git('diff', '--cached', '--numstat', '--no-renames', '-z', '--', path).startsWith('-\t')) continue;
     // Consume the blob fully: closing a pipeline at line five can cause SIGPIPE.
     const firstLines = git('cat-file', 'blob', `:${path}`).split('\n', 5).join('\n');
     if (/@generated|auto[- ]?generated|do not edit|code generated by/i.test(firstLines)) continue;
-    offenders.push(`${JSON.stringify(path)}: ${Math.floor(bytes / 4)} tokens`);
+    advisories.push(`${JSON.stringify(path)}: ${bytes} bytes`);
   }
-  if (offenders.length) {
-    console.error(`Staged files exceed 5000 tokens (20000 bytes; tokens = floor(bytes / 4)):
-${offenders.join('\n')}
-
-Split each file before committing:
-1. Find seams: group top-level units by responsibility.
-2. Create a folder named after the original file, with one module per responsibility.
-   TS: foo.ts -> foo/types.ts, foo/parse.ts, foo/index.ts.
-   Rust: foo.rs -> foo/mod.rs + submodules with re-exports.
-   Svelte: child components + a .ts module for pure logic.
-   Specs: one spec per describe block or behaviour.
-   HTML docs: one doc per topic, linked from an index.
-3. Keep the public surface stable via re-exports, or update all imports in the same commit.
-4. Move code verbatim first, then refactor in a separate commit.
-5. Aim for ~3000 tokens per file.
-6. Stage the new files and re-commit.
-If truly generated or recorded data, add a glob to ${JSON.stringify(ignoreFile)}
-or give the file a generated banner in its first 5 lines.`);
-    process.exit(1);
+  if (advisories.length) {
+    console.error(`Advisory: staged files above 20000 bytes (size alone does not block committing):
+${advisories.join('\n')}
+Review file structure and responsibilities; no size-only split or approval is required.`);
   }
 } catch (error) {
   console.error(`Staged-file token check failed: ${error.message}`);

package/skills/axstack-implement/SKILL.md

@@ -166,11 +166,17 @@ applied or found not applicable in the `Simplification:` line of the
 including evidence and retained complexity.
 
 Before every commit, the author runs the
-[staged-file token gate](../axstack/scripts/check-staged-file-tokens.js)
+[staged-file size check](../axstack/scripts/check-staged-file-tokens.js)
 with `bun` from the target repository.
-If the gate fails, split files per its instructions before retrying.
-Never bypass the staged-file token gate.
-Record the staged-file token gate result in the implementation receipt.
+Successful staged-file size measurements, including files above 20,000 bytes,
+are advisory and exit 0.
+Never require splitting files solely for size.
+Never request user approval solely for file size.
+Review file structure and responsibilities even when size is advisory.
+Git, read, malformed-size and unmerged-index errors must fail with a nonzero exit.
+Resolve measurement errors before committing; keep repository-owned checks enforceable.
+Preserve the check's exclusions, but never hide authored files behind generated banners or ignore globs.
+Record the staged-file size check result in the implementation receipt.
 
 ## 5. Verify and return the candidate
 
@@ -199,7 +205,7 @@ Owner: <profile + session ID + worktree>
 Scope: <approved spec + capability | small-change intent | maintenance snapshot>
 Shape: <total> lines vs base <sha>; bulk: <buckets>; theme: <one line>
 TDD: <normal red/green | structure-preserving old-green/same-check-new-green evidence | F-repair base-green/removal-inversion-red/rewording-green evidence>
-Token limit: <staged-file gate command + observed result before each commit>
+Token limit: <staged-file size check command + observed advisories/errors before each commit>
 Simplification: <applied | not-applicable> — evidence: <diff locations and checks>; retained complexity: <necessary complexity and why>
 Acceptance: <checks + observed results>
 Dependencies: <parent revisions or none>